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A A Incorporation 



~ 1 f 



TM 
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?! 



/*while pjist*/ 

iteration += 1.1; 
Main_l oop jPactor++ ; 

/* (for demo's — in case lines inserted/deleted) */ 



1 
92 

| 

95 
96 
97 
98 
99 

100 End_Loop: 
101 

102 > /*while TRUE*/ 

103 

104 } /attain*/ 

-Enter : Change 

X:003E uint ai 
X:0090 uint aj 
XI008E uchar aryCai] 
X 18884 [101uchar ary 

X 10084 uchar 

XI00A5 ->struct List listjiead 



-Source- 



/* scan through nodes in list */ 
p list = listjiead: 
wKile (pjist != NULL) i 

lj = p_list->list_uival ; 



-Fiie:takf511.ao»— , 



x:009C 

XI009C 



X = 
_.XJ0097 
^Enter _ 
X;008C Mnter 



flddr 



==X:009E ->struct List= 

::0899 ->struct List 
Addr Data Type Value 



10 
21 

0X00 ' .' 

[10] uchar 
[ 0] 0x03 
[ 1] 0x05 
— =il 0x07 



-Ctrl-B:Browse- 







K:008D uchar 
XI00A8 ->struct List 
C:0000?struct List 
C:0000?uint 



er: Change 




1:0092 struct List 
:0092 uint 



Pjist 
*P_list 



(null) 
struct List 
list_uival 



1 

13 
15 

it 



517 



S : 88S3 ? ;it? t r uct A i ? t i •; HsO nxt ?:ffff<ceffff> 

V'RCIOO rilri«n«* T;.-± ««J«~ rn_j.....-.I i : _.' 



XJ0092 [31struct List 
XI0092 struct List 
X:0892 uint 
XI0094 ->struct List 
X 10097 struct List 
XI0097 uint 
X',0099 ->struct List 
XI009C struct List 
XI009C uint 
X1009E ->struct List 



nodes 



[3]struct List 
[0] struct List 
list_uival 
iistvjixt 
[1] struct last 
list_uival 



[2] 



5t_pjnxt 



3 

(null) 
7 

X:8092 



struct 

list_uiwal 11 
list_P nxt X 10097 
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Chapter 1: Introduction 

iceMASTER Host Software Version 3.3 contains these major enhancements: 

■ All address, length or count specifications can now be general expressions, rather than just a single 
symbol or constant. v<Q*'V •' 

■ Support for long integer, single-precision (float) and double-precision* (double), floating-point 
variables 

- Display 

- Input .w:vA\t±r»vv.\Q. 

■ Full support for structures, unions, arrays and pointers m v > - r»fcr ' 

- Display/Change ~~ ~~ 

n J bcrmra / } 

Watch Window 

* Display/Alter | Expression command " !*® ,f »* 3 ^ 

* Source/Symbols \ Global command 

* Source/Symbols \ Local command 

* Source/Symbols \Address command 

* Source/Symbols \Alpha command 

- Full structure, union, array & pointer support for these compilers: 

* Keil/Franklin C51 

* IAR/Archimedes C-51 

* (others coming soon) 

■ Data Structure Browser/Inspector 

- Inspect structures, unions and arrays 

- Follow pointers 

- Change any value at any point along the way 

- Backtrack 

■ True Expressions in Watch Window (not just static addresses) 

- Indirection through NULL or invalid pointers is flagged in the display. 

■ OS-Escape ("Shell-Out") to DOS during Emulation 

- OS-Escape Hot Key: Alt-O 

- Emulation continues while working in DOS. 

- All DOS memory, except about 7K-10K bytes, available during all OS-Escapes 

■ Supports all iceMASTER hardware products 

- iceMASTER Model 200/400 Emulators (MCS-51, COP8, 68HC11 & 68HC05) 

- iceMASTER-FE Emulators 

- iceMASTER-COP8 Debug Modules 
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The following features were added in earlier versions of the iceMASTER host software. Depending on 
which iceMASTER hardware product you purchased, these features may or may not be documented in 
the primary manual: 

■ Source Window & Assembler/Disassembler Enhancements 
(software version 3.2 - see Appendix A) 

i\ !«bai«J sriT ~ "Source-Only" display mode option in Source Window 

- Assembler /Disassembler Window fully-scrollable 

- Set permanent break- points directly in Source or Assembler/Disassembler Windows 

- Set temporary break-points directly in Source Window 

■ Virtual Memory Support 

(software version 3.1 - see Appendix B) 

- Allows host software to use Expanded Memory for large programs 
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Chapter 2: Tutorial 



Here is short tour through some of the new features in the iceMASTER host software. The tutorial is 
based primarily on the C program TA.C shown on the following pages. 
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Program TA.C 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 



/* ta.c */ 

/* #defines set on compilation command line: 



** 


K F 


Keil/Franklin 


** 


I _ A 


IAR/Archimedes 


** 






** 


LARGE 


large memory model 


** 


COMPACT 


compact memory model 


** 


SMALL 


small memory model 


** 






** 


A51 


8051 architecture 


** 


All 


68HC11 architecture 


*/ 







#ifdef K_F /*{*/ 

# pragma pi (86) /* 

# pragma pw(132) /* 
#endif /*K_F*/ /*}*/ 



#include <stdio.h> 
/*#include <stdarg.h>*/ 
#include <string.h> 

#if defined(LARGE) 

# define ARYSIZ 10 
#elif defined(COMPACT) 

# define ARYSIZ 7 
#elif defined (SMALL) 

# define ARYSIZ 4 
#else 

??? /*(force syntax 
#endif 



Listing File Page Length (lines) */ 
Listing File Page Width (characters) 



*/ 



/*{ ( 
/*}{ 
/*){ 



# 
# 



define 
define 



LIST 

true" 



SIZ 



error)*/ 
/*} ) 

3 
1 



large memory model */ 
compact memory model */ 
small memory model */ 

memory model */ 



/* typedefs */ 
/************ / 

typedef unsigned 
typedef unsigned 



char 
int 



uchar ; 
uint ; 



#if defined(K_F) 

typedef struct List 
uint 

struct List* 

} LIST; 
typedef struct List* 
#elif defined(I_A) 

typedef struct List* 
typedef struct 

uint 

P_LIST 

) LIST; 
#endif /*compiler*/ 



/*{ (*/ 



{ 

list_uival ; 
list_p_nxt ; 



P_LIST; 
P_LIST; 



/*}{*/ 



List { 

list_uival ; 
list_p_nxt ; 



/*} )*/ 
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8 

- 

- 

- c i 



56 

57 /**********/ 

58 /* main() */ 

59 /*******•*•*■*/ 

60 main () 

61 ( 

62 float iteration =0.0; 

63 uchar ary[ARYSIZ] ; 

64 uint ai = 1 , aj = 2 ; 

65 LIST nodes [ LI ST_S IZ ] ; 

66 uint li, lj ; 

67 P_LIST list_head = (P_LIST)NULL; 

68 P_LIST p_list; 

69 uint main_loop_f actor = 1; 
70 

71 while (TRUE) { 
72 

■ 

73 Array_Init: /* (for demo's -- in case lines inserted/ deleted) */ 

74 /* array demo */ 

75 for ( ai = 0; ai < ARYSIZ; ai++ ) ( 

76 aj = (ai * 2) + main_loop_f actor ; 

77 ary[ai] = aj ; 

78 } /*for ai*/ 
79 

80 List_Init: /* (for demo's -- in case lines inserted/ deleted) */ 

81 /* structure/list demo */ 

82 /* initialize fields/links */ 

83 for £ li - 0; li < LIST_SIZ; li++ ) { 

84 nodes [ li] . list_uival = (li * 4) + main_loop_f actor ; 

85 nodes [li] .list_p_nxt = (li = 0) ? NULL : &(nodes [li-1] ) 

86 } /*for li*/ 

87 list_head = &(nodes [LIST_SIZ-1] ) ; 
88 

89 List_Scan: /* (for demo's -- in case lines inserted/deleted) */ 

90 /* scan through nodes in list */ 

91 p_list = list_head; 

92 while (p_list != NULL) { 

93 lj = p_list->list_uival ; 

94 p_list = p_list->list_p_nxt; 

95 } /*while p_list*/ 
96 

97 iteration += 1.1; 

98 main_loop_factor++ ; 
99 

100 End_Loop: ; /* (for demo's -- in case lines inserted/deleted) */ 
101 

102 } /*while TRUE*/ 
103 

104 } /*main*/ 



; 
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Watch Window 



The program has two parts. The first part is a loop to initialize the elements in an array of unsigned chars. 
The second part uses an array of structures to implement a singly-linked list. The first sub-loop in this 
second part establishes the linkage through the nodes in the list. The second sub-loop traverses the linked 
list using a pointer variable. 

We have already loaded the program TAKF5 1L.AO M into the iceMASTER emulator (TAKF51L.AOM: 
Test/program A, Keil/Franklin compiler, MCS-51 chip architecture, Large memory model, Absolute 
Object Module format). We have also opened the Watch Window and set several Watch Expressions: 



Conf igure File 
■ Modu 1 e : TA 



Display/Alter Hisc Source/Symbols Break/Trace Help 
Source F i 1 e : takf 5 1 1 . aom- 



76 
77 
78 



X:008E 
X:0090 
X:0B85 
X:B884 
X 0084 
X:0085 
:8086 
:0087 
"8088 
:8889 
X:088A 
X:808B 
X • 868C 
X:088D 



for < ai = 0; ai < ARVSIZ; ai*+ ) < 



aj = Cai * 2) + main_loop_f actor; 
aryCai] » a jJ 
> /*for ai»/ 

Uatch 



X: 
X: 

X: 
X: 



u irit 

u int 

uchar 

[181uchar 

uchar 

uchar 

uchar 

uchar 

uchar 

uchar 

uchar 

uchar 

uchar 

uchar 



ai 

aj 

ary [ai ] 
ary 



i 

2 

0xFF ' .' 255 
[18 I uchar 



[ 


0] 


0xFF 


J 


J 


255 


[ 


1] 


8xFF 


J 


9 


255 


[ 


21 


0xFF 


J 


J 


255 


[ 


3] 


BxFF 


1 


f 


255 


[ 


41 


BxFF 


$ 


J 


255 


[ 


53 


0xFF 


f 


f 


255 


[ 


6] 


8xFF 


» 


$ 


255 


[ 


73 


0xFF 


J 


» 


255 


[ 


8] 


BxFF 


i 


> 


255 


[ 


91 


8xFF 


M 


J 


255 



B egin emulatio n 



urMod 
oUnt i 1 



The program is about to step through the array ary to initialize each element. There are four Watch 
Expressions in the Watch Window, ai and aj are simple unsigned integer variables at locations 0x008E 
and 0x0090, respectively, in External Data memory. Their current values are 1 and 2 (from source line 
#64). The third Watch Expression, ary[ai] monitors a single element in the array ary, but the element 
being monitored changes as the value of the subscript ai changes. The fourth Watch Expression, ary, 
watches the entire array. The "value" shown for ary is its data type: "[10]uchar", meaning that it is an array 
of 10 elements, each of which is an unsigned char. Following this header line for the array, each element 
in the array appears. The current value in each element is displayed in hexadecimal, character and 
unsigned decimal formats, preceded by the element's actual subscript. 
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Let's single-step the program by one HLL (Higher-Level Language) source line: 



Configure File 

i Mod u 1 e : TA 

75 for 



77 
78 



D i sp 1 ay/ A 1 ter M i sc Sour ce/Symbo 1 s 
Source 



Break/ Trace Help 
— Ftle:takf511 .aom- 



( ai 

m 

ary tail = aj 
> /«for ai*/ 



8; ai < ARVSIZ; ai** ) < 



= Cai * 2) * main_loop_f actor; 



-Uatch- 



X:088E uint 
X:8090 uint 



uchar 
X:0084 [ 10] uchar 
X:0084 uchar 
X:0085 uchar 
X:8086 uchar 
X:0887 uchar 
X:8088 uchar 
X:8B89 uchar 
X:088A uchar 
X 008B uchar 
X:808C uchar 
X:008D uchar 



ai 

aj 

ary [ail 
ary 



2 

2 

BxFF ' . ' 255 
[10] uchar 



[ 


0] 


BxFF 


J 


J 


255 


t 


1] 


BxFF 


9 


9 


255 


[ 


2] 


BxFF 


9 


9 


255 


[ 


3] 


BxFF 


9 


9 


255 


[ 


4] 


BxFF 


9 


9 


255 


[ 


5] 


BxFF 


9 


9 


255 


[ 


6] 


BxFF 


9 


9 


255 


[ 


7] 


BxFF 


9 


9 


255 


[ 


8] 


BxFF 


9 


9 


255 


[ 


9] 


BxFF 


9 


t 


255 



Begin emulation 
si 



The program just executed the for loop initialization statement (ai = 0;) and is about to execute the first 
line in the for loop. Notice that the value of ai has changed from 1 to 0; it is highlighted to notify you that 
the value changed. Also note that the address for the Watch Expression ary[ai] has changed (because the 
subscript value ai changed); it, too, is highlighted to flag the change. 

Now, lets step twice to get past the first array element assignment at line #77 at the end of the loop: 

Configure File i!7TW Display/Alter Misc Source/Symbols Break/ Trace Help 
■ Module : TA Source File:takf511 .aom ■ 



75 for < ai = 8; ai < ARVSIZ; ai** ) { 

76 aj = Cai * 2) + ma in_loop_f actor; 

77 aryCai] = aj; 

Uatch 

X:888E uint ai 8 

X:8898 uint aj 1 

X:0884 uchar ary tail IQHSBflB 

X:0884 ClBluchar ary ClBluchar ^^^^^ 

X:8885 uchar [ 1] BxFF '.' 255 

X:0086 uchar [ 21 BxFF '.' 255 

X:8887 uchar [3] 8xFF ' .' 255 

X:8088 uchar [4] BxFF ' 255 

X:8089 uchar [ 5] BxFF ' .' 255 

X:0B8A uchar [6] 0xFF ' .' 255 

X:B08B uchar [7] BxFF ' .' 255 

X:808C uchar [8] BxFF ' .' 255 

X:888D uchar [9] BxFF ' 255 



Begin emulation 




After executing the assignment ary[ai] = aj;, we see that the value stored in the first element (subscript 
value zero) has changed, and the corresponding change is reflected in the copy being monitored by Watch 
Expression aryfai]. 

Let's take several more trips through the loop: 
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Configure File iiTBfl Display/Alter Hisc Source/Symbols Break/Trace Help 
, Module :TA Source File:takf5il .aon . 



75 for ( ai = 8; ai < ARVSIZ; ai» * ) i. 

77 aryEail = aj; 

78 > /«for ai*/ 1 

Uatch 

X:888E uint ai 3 

X:B898 uint aj 7 

>'M'AM:] ucW arytai] 

X:8884 [lBluchar ary [lBluchar 

X:8084 uchar [81 8x81 ' .' 1 

X:8885 uchar [ 11 8x83 ' .' 3 

X:8886 uchar I 21 8x85 ' .' 5 

X:8887 uchar [3] 8x87 ' .' 7 

X:8888 uchar [43 BxFF ' .' 255 

X:8889 uchar [51 BxFF ' ,' 255 

X:808A uchar [61 BxFF ' .' 255 

X:008B uchar [71 BxFF '.' 255 

X:888C uchar [8] BxFF ' .' 255 

X:8B8D uchar - - [ 91 BxFF '.'255 



Begin emulation 








i j 


1 SSI 

















We're again at the first statement in the loop after making four complete passes through the loop. The 
first four elements in the array have been initialized and the subscript ai is set for the fifth element in the 
array. Now let's step to the end of the loop one more time: 

Configure File iflTW Display/Alter Misc Source/Symbols Break/Trace Help 
■ Modu 1 e : TA Source F 1 1 e : takf 5 1 1 . aom ■ 



75 for ( ai = 8; ai < ARVSIZ; ai*+ ) < 

76 aj = Cai * 2) + ma in_loop_f actor ; 

77 ary [ail - aj; 

Uatch 

X:888E uint ai 4 

X:8B9B uint aj 9 

X:8088 uchar arytai] ]23jlHMiE 

X:8884 (lBluchar ary [lBluchar 

X:8884 uchar [8] BxBl '.' 1 

X:8885 uchar [ 11 8x83 ' .' 3 

X:0886 uchar [21 8x85 ' .' 5 

X:8887 uchar [3] 8x87 ' .' 7 

X:B088 uchar [ 4 J lEEMi^BS 

X:8089 uchar - [51 BxFF '.' 255 

X:B08A uchar [61 BxFF ' .' 255 

X:888B uchar [ 71 BxFF ' .' 255 

X:088C uchar [ 81 BxFF ' .' 255 

X:8B8D uchar [ 91 BxFF ' .' 255 



Begin emulation 




Let's move on to the second part of the program. 
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Configure Filf 
Modu 1 e : TA 



Display/Alter disc 
Source 



Source/Synbo Is 



list = list head; 



Break/ Trace Help 
— File:takf511 .aom- 



92 while (p_list != NULL) < 

93 lj = p_l ist->l ist_uiwal ; 

94 P_list = P _list->list_p_nxt; 

95 > /«uhile p.list*/" 
Uatch 

X:88A8 ->struct List p_list ? :FFFF«TFFFF> 

C : FFFF?struct List «p_list struct List 

C:FFFF?uint list_uival 65282 

C:888i?->struct List list_p_nxt C:CEFF 

X:8892 [3]struct List nodes [Slstruct List 

X:B892 struct List [81 struct List 

X:8892 uint list_uiual 1 

X:8894 ->struct List list_p_nxt (null) 

X:8897 struct List [1] struct List 

X:8897 uint list uiual 5 

X:8899 ->struct List list_p_nxt X:8892 

X:889C struct List [21 struct List 

X-'889C uint list_uiwal 9 

X:B89E ->struct List list_jp_nxt X:8B97 



Begin emulation 



■tEnejResetTgL^o 



oUnt i lflStep Ins^JStepL i ntJStepOurjjStepTo 



At this point, the program has executed the first sub-loop that establishes the list linkage through the 
structure nodes in the array nodes (an array of structures). The list head pointer, listjiead, has been set 
to point at the first node in the list. That node is the last element in the array (subscript value [2], at address 
0x009C in External Data memory), as the list was linked "backwards" through the array elements. The list 
is linked using the list _p_nxt field in each node. 

The Watch Window contains three Watch Expressions. 

The variable pjist is a pointer to a LIST node and it currently contains an illegal pointer value. That's 
fine because the program has not yet assigned a value to pjist. A pointer such as pjist occupies 3 bytes 
in memory. The first byte contains a selector value that indicates which memory space (e.g, Code memory, 
External Data memory, etc.) is being referenced by the rest of the pointer. The other two bytes in the 
pointer contain the offset into that memory space. In this case, the memory space selector value is invalid 
(OxFF), so the software displays it's code as a question mark (?) followed by a colon (:) and the offset 
bytes in hexadecimal. In addition, because the pointer is illegal, all three "raw" bytes in the pointer's value 
are displayed in hexadecimal within braces. 

The second Watch Expression, *p_list, is much like the Watch Expression aryfaij used in the earlier part 
of this tutorial. The expression *p_list designates "the object pointed to by the pointer pjist" (C 
indirection). In this case, the object is a structure of type struct List. That structure has two members: 
an unsigned integer listjiival and a pointer, list J>_nxt, to another instance of the same structure type. 
Note the question marks (?) between the address and data type name fields for the structure denoted by 
the Watch Expression *p_list. The host software is flagging this object specially because it had to "follow" 
an invalid or NULL pointer to get to the object. 

The third Watch Expression is nodes, which is the array of structures containing the nodes in the linked 
list. 

Let's execute the highlighted line to initialize pjist so that it points at the first node in the chain: 
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Configure Fil 

i Modu le : TA 

91 



Display/Alter Misc Source/Symbols 
Source 



Break/ Trace He 1 p 
— File:takf511 .aom- 



p_list = list_head; 



uhile (p_list •= NULL) { 



93 lj = p_l ist-> 1 ist_u iwal I 

94 p_list = p_list->list_p_nxt; 

95 > /*uhile p_list*/ 
Uatch 

X:00A8 ->struct List p_l ist ggsIsfcM 

struct List *p_list struct List 

uint list_uival S 

~>struct List - - • 1 ist_p_nxt SJsJsJH 

X :8892 [3] struct List nodes [31struct List 

X:8892 struct List [0] struct List 

X:0092 uint list_uiual i 

XI0094 ->struct List list_p_nxt (null) 

X:8897 struct List til struct List 

X:8097 uint list_uiual 5 

X : 8099 ->struct List list_p_nxt X:0092 

X:809C struct List [2] struct List 

X:009C uint • -- list_uiwal 9 

X:809E ->struct List Iist_p_nxt X:0897 




Begin emulation 

u 



lp 2ResetEmSlResetT«2Go 



Notice that pjist now contains a valid pointer value and that the node denoted by the expression *p_list 
is the first node in the linked list. Let's step through to the end of the first pass in this loop: 



Configure File 
i Module :TA 



Display/Alter Misc Source/Symbols 
Source 



Break/ Trace Help 
— File :takf 511 .aom- 



91 
92 
93 
94 



p_list = 1 ist .head ; 
uhile (p_list != NULL) { 

lj = p_l ist->l ist_uiwal ; 

p_l ist = p list— >list_p nxt; 



> /*uhile p_l ist*/ 



X:00A8 




X:8892 
X.8092 
X:8892 
X:8894 
X:8097 
X:0097 
X:0099 
X:009C 

X: 



Watch - 

->struct List p_l ist 

struct List «p_list struct List 

uint list_uiual 3 

->struct List 1 ist_p_nxt JjEOESB 

[3]struct List nodes [31struct List 

struct List [0] struct List 

uint list_uival 1 

->struct List list_p_nxt (null) 

struct List [ij struct List 

uint list_uiual 5 

->struct List list_p_nxt X:0092 

struct List [21 struct List 

uint list_uiual 9 

->struct List list_p_nxt X:0097 



Begin emulation 



pjist now points at the second node in the chain and the updated Watch Expression *p_list shows a 
: node. 



Finally, let's step until very end of the loop: 
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Display/Alter Misc Source/Symbols 
Source 



Configure File 
i — Module :TA 

91 P_list = listjiead; 

92 while (p_list ♦= NULL) < 

93 lj p_list->list_ui«al; 
94 p_l ist = p_list->list_p_nxt: 



> /awhile p_list»/ 



Break/ Trace Help 
— File:takf511 .aon- 



(null) 




Uatch- 

X:B0A8 ->struct List p_l ist 

?struct List *p_list struct List 

'uint list_uiwal 

->struct List iist_p_nxt (**J*J£(«AJJ1*', 

X:889Z t31struct List nodes [31struct List 

X:0092 struct List [0] struct List 

X:8092 uint list_uival 1 

X:B894 ->struct List list_p_nxt (null) 

X:8097 struct List til struct List 

X:8897 uint list_uival 5 

X:B099 ->struct List list_p_nxt X:0892 

X:009C struct List 121 struct List 

X:809C uint list_uiwal 9 

X:809E ->struct List list_p_nxt X:0097 



B egin em u lation 



oUnt i lSStepI nsJiStepL inBStepOurTBtepTo 



Here we see that pjist is NULL, as expected. Also note that the object denoted by the expression *p_list 
is again flagged as "bad" because the iceMASTER host software followed a NULL pointer to get to it. 

You can "jump into" the Watch Window to browse/inspect/change the values in objects designated by the 
Watch Expressions. To do this, select the Configure {Windows \(Joto command (shortcut: press the Tab 
key). As you scroll up or down, if the currently highlighted item is a scalar (integral or floating-point) or 
a pointer, you will see the EntenChange prompt appear on the top-left border of the Watch Window. 
When you press the Enter key, a Change Box pops up to allow you to change the value stored in the 
highlighted item. A Change Box shows the address, size and data type of the object, as well as its current 
value. In this case, we are given the opportunity to change a member (list jiival) in a structure (which is 
itself an element in an array): 



iiii;;i!i;;;!!!;:l:h::!;n;U;j:i;'i 

, Module :TA 

91 
92 
93 
94 
95 



P_list = list_head; 
uhile ( P _list t= NULL) { 

lj = p_l ist->l ist_uiual ; 

p_list = p_list->list_p_nxt; 
> /"while p_list*/ 

—Enter : Change 

X:00A8 ->struct List p_l ist 
C:0000?struct List *p_list 
C:00007uint 



— Source- 



File:takf511 



.aom- 



C:8002?->struct List 
X:0092 [33struct List 
X:0092 struct List 



X:0092 uint 



nodes 



(null) 
struct List 

list_uiual 517 
1 ist_p_nxt ? : FFFF-fCEFFFF} 
[31struct List 
[01 struct List 



list uival 



lange Ualue (Content) 
Addr: X:0092 Size: 2 bytes Type: uint 
Content 



Current : 
New : 



Esc: Do not change current ualue 



X:009E ->struct List 



1 ist_p_nxt (nu 1 1 ) 
11 struct List 

list_uiual 5 
list_p_nxt X:0892 
2 ] struct L ist 

list_uiual 9 
list_p_nxt X:0097 



Tah/Shif t-Tab :Next/Preu window (Keypad) :Scrol 1 Esc: Ex it 



If the currently highlighted item is a pointer, structure, union or array, you will see the Ctrl-B:Browse 
prompt appear on the top-right border of the Watch Window. This means that you can "browse" (inspect 
and/or change) the designated object. Here we'll press Ctrl-B to pop up a Browse Window to look at the 
node pointed at by the link field (list _p_nxt) in the first node in the list (that is, we'll "follow" the pointer): 



p_l ist = list_liead; 
while (p_Iist •= NULL) < 

lj = p_list->list_ui«al; 
P_list = p_list->list_p_nxt; 
> /wyhile p_list*/' 



Module :TA- 

91 
92 
93 
94 
95 

—Enter : Change- 
X00A8 ->struct List p_l ist 

0:8888(1 X:889E ->struct List 

C:eeee Addr Data Type Ualue 
C:BB82 
X:B892 
X:8892 
X:8892 
X:8894 

X:8897 struct List 
X : 8897 uint 
X8899 ->struct List 
X:889C struct List 
X:889C uint 



— Source — 



-Flle:takf511 .aon — 



-Ctrl-B: 



(null) 

it List 
t_ui«al 517 

nxt ?:FFFF<CEFFFF> 



:8897 struct List struct List 



X:8897 uint 

X:B899 ->struct List 



list_uival 5 
list_p_nxt X:B892 



1 

(null) 



X:8B9E ->struct List 



ruct List 
struct List 
1 ist_uival 
list_p_nxt 
[11 struct List 

list_uiwal 5 
list_p_nxt X:8892 
[21 struct List 

list uiual 9 



list_p_nxt X:8897 



lab/Shift-Tab :Hext/Preu uindou 



(Keypad) : Scroll 



Esc: Ex it 



A Browse Window shows the entire object denoted by the pointer. A Browse Window is scrollable, 
moveable and resizeable. Thus, you can inspect large objects with no problem. You can even write the 
entire contents of a Browse Window to a file of your choice. Let's move the highlight bar to the link field 
(list _p_iixt) in the struct we are inspecting: 



i Modu 1 e : TA 



—Enter : Change 
X:88A8 ->struct List 
C:8BB8 



'iSll 

Source- 



-File:takf511 .ao«- 



91 
92 
93 
94 
95 



p_l ist = list_head; 

while (p_list f= NULL) < 

lj a p_list->list_ui«al: 

p_list = p_l ist->l ist_p_nxt: 
> /«uhile p_list*/- 



-Ctr 1-B : Browse— 



c: 
C:B8B2 
X:B892 
X:8892 
X:8892 



Addr 



P_l ist 

X:8B9E ->struct List= 

Data Type Ualue 



X:8897 struct List 
X:8897 uint 



X:BB99 ->struct List 



struct List 
list uiual 



X : 8894 >i=Enter : Change 
X:8897 struct List 
X:8897 uint 
X:8899 ->struct List 
X:B89C struct List 
X:BB9C uint 



X:889E ->struct List 



;t_p_nxt X:8892 



:trl-B:B 



(null) 

t List 
t_uival 517 

t_p_nxt ?:FFFF<CEFFFF> 
ruct List 
struct List 
list_uiwal 1 
1 ist_p_nxt (nu 1 1 ) 
til struct List 

list_uiual 5 
list_p_nxt X:B892 
[2] struct List 

1 i st uiual 9 



list_p_nxt X:BB97 



Tab/Shift-Tab:Next/Preu window 



(Keypad) : Scroll 



Esc: Ex it 



Notice that the bottom border of the Browse Window shows that we can change this pointer value 
(EntenChange on the left) or we can follow it (Ctrl-B:Browse on the right). Let's follow it to the next 
node in the list. 
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, — Module :TA 

91 
92 
93 
94 
95 



—Enter : Change- 
X:80A8 ->struct List p_l ist 



Source Fi le :takf 511 . 



p_list = list_head; 
while ( P _list != NULL) < 

lj = p_list->list_uiwal; 

P_list = p_list->list_p_nxt; 
} /««hile p_list»/ 



-Ctrl-B: 



Addr 



X:8897 
X:8097 



C: 
C 
C 

X:8892 
X:0092 
X.-8892 
X:8894l!=Enter 
X:8897 struct 
X:8897 uint 
X:8099 ->struc 
X:889C struct 
X=889C uint 



X:BB9E ->struc 



=X:8B9E ->struct List= 



X:B899 ->struct List= 
Addr Data Type Value 



(null) 

Tit List 



X:8092 struct List 
X:8892 uint 



struct List 
list.uiwal 1 



j94 ->struct List list_p_nxt (null) 



517 

?:FFFF-CCEFFFF> 
st 
List 
u i ua 1 1 
P nxt (null) 



Change Ualue (Content) 3 
Addr: X:8B94 Size: 3 bytes Type: ->struct List 
Content 



Current : (null ) 
New : 



:Bx009C 



Esc: Do not change current value = 



Tab/Shift-Tab :Next/Preu window 



elp £fflesetEm«jResetTcf3Go 



(Keypad ) : Scro 11 



Esc : Ex it 



ollnt i IrtStepInsiJStepL inBStep0ur2StepTo 



Here we see that we are at the last node in the linked list (the link field list _p_nxt is NULL). Let's move 
to that field and change the link to make the list circular . We'll set the link field to point at location 0x009C 
in External Data memory. That is the location of the head (first) node in the chain. 

Now if we continue to follow the link field (repetitively pressing Ctrl-B while the highlight bar is on the 
member list _p_nxt), we'll go on, and on, and on ... 



le : TA- 



-Source- 



-File:takf511 . 



91 
92 
93 
94 
95 

—Enter : Change 

X:88A8 ->struct List 
C:0888 
C:B088 



p_list = list_head; 
while (p_list ?= NULL) { 

lj = p_l ist->l ist_uiwal ; 

p_list = p_list->list_p_nxt; 
> /-while p.list*/" 



-Ctrl-B 



C:B002 
X:8092 
X:8892 



Addr 



p_l ist 
X:889E ->struct List 

X:8899 ->struct List 



(null) 

l| t List 



Addr 



=i, 517 



X:8897 
X:8097 
=X:8894 ->struct List 



X:8892 



Addr 



=X:0894 ->struct List= 
X:889E ->struct List" 



=T]-fCEFFFF> 



Addr [j= 



Addr 



X:889C 
X:BB9C 




Addr 



X:8897 
X:8897 



:889E ->struct List= 

=X:8899 ->struct List 
Addr Data Type Ualue 



X:BB99 ->struct List= 
f| Data Type Ua lue 

=fl 



:8892 struct List struct List 



uitxci X:B892 uint 
l!=Enter X:B894 ->struct List 



list_uiwal 1 
listjp_nxt X:889C 



struct List 
1 ist u i ua 1 



list_p_nxt X:8B9C 



Ctrl-B 
t_ui«al 9 



t_p_nxt X:B897 



Tab/Shift-Tab :Next/Prev window 



elp aResetEngReset Tg 



(Keypad) : Scro 11 



Esc: Ex it 



toUnt i 1 nStep I lisijS tepL i ngStepOurljStepTo 



Enough. 
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Display/Alter | Expression Command 



The Uisplay/Alter\Expression command pops up a dialog box which allows you to view or change the 
value stored in a location designated by an arbitrary expression: 



Configure File Run 



l Module : 


TA— 






92 




uhile (p 


93 




lj 


94 




P_H 


95 




> /« 


X:88A8 - 


>struct List 



C:0888?struct 
C:8000?uint 
C:8882?->stru 
X:0092 I31str 
X:8092 struct 
X 8092 uint 
X 0094 ->stru 
X:8097 struct 
X:8097 uint 
X:0899 ->struct List 
X:009C struct List 
X:889C uint 

->struct List 



isplay/A Iter 



Misc Source/Symbols 



Asm/Basra Shift-F4 V 



Code 

Idata 

Xdata 



Alt-F2 
Alt-F3 
Alt-F4 



xpression Alt— F5 



Break/ Trace Help 
— FIle:takf511 .aon- 



Expression: iteration 



2 1| (null) 
Display/Alter Expression 



Addr: X:0088 Size: 4 bytes Type: float 
Content 



2.2 



Current : 
Mew: 

== Esc: Do not change current value 



B89E 



list_uival 7 
list_p_nxt X:8B92 
[2 1 struct L ist 

list_uival 11 
list_p_nxt X:8897 



Uieu/change the value in any variable, register, bit, memory location, etc 



12 



gResetEmCtResetTgTCo 



i ISStepInsiStepLiiiBStepOiPriJStepTo 



The dialog box shows the address, size (in bytes or bits) and data type of the object denoted by the 
expression you type (in this case, the variable iteration). Additionally, it shows the current value of the 
expression (2.2 in this case), and gives you the opportunity to assign a new value to the location designated 
by the expression. Here we are changing the value/content of iteration from 2.2 to 5.5). 



If the expression has type "pointer to you can either change the pointer's value by entering a new value 
or follow the pointer (the Ctrl-B:Browse prompt appears on the bottom-right border of the box): 



Configure File Run E 
■ Modu le : TA 



isplay/A Iter 



M i sc Source/Symbo 1 s 





92 


uhile (p 


93 


lj 


94 


P_H 


95 


> /* 



X:B8A8 ->struct List 
C:8088?struct 
C:B888?uint 
C:8882?->stru 
X:8892 [31str 
X:8892 struct 
X:8892 uint 
X:8894 ->stru 
X:8897 struct 
X:8097 uint 
X:8899 ->struct List 
X:889C struct List 
X:889C uint 
X:889E ->struct List 



Asm/Dasm Shift-F4 ► 
Memory- 



Code 

Idata 

Xdata 



AIt-F2 
Alt-F3 
Alt-F4 



Break/ Trace Help 
— File:takf511.aom- 



Cnull) 



Express ion : 1 ist_head 



=D isplay/A Iter Express ion= 



Addr: X:00A5 Size: 3 bytes 



Current: X:889C 

= Esc: Do not change current ualue 



Type: ->struct List 
Content 



tr 1-B : Brouse- 
list_uival 7 
list_p_nxt X:B892 
[21 struct List 

list_uival 11 
list_p_nxt X:8897 



Uieu/change the ualue in 

12 



2ResetEmgResetTg3Go 



5oUnt i lOStep InsJjStepL iiiBStepOuriJStepTo 



any var i able, register, bit, memory location, etc. 

5 .effljyiffl fc> ;fl7inmi 7-H 
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If we choose to follow it by pressing Ctrl-B, again a Browse Window pops up to let us do just that: 



Configure File 
■ Mod u 1 e : TA- 



isp lay/A Iter 



Misc Source/Symbols 



Break/ Trace Help 
-Flle:takf511 . 




View/change the value in any variable, register, bit, memory location, etc 



3ResetEm£]Reset Tg 



5oUnt i lr3StepInsaStepLinBStepO«r2StepTo 



If the expression has type "array of the Display /Alter\E^cpression command shows us the size of the 
entire array nodes (15 bytes in this) case and prompts us that we can browse (inspect) the array 
(Ctrl-B:Browse prompt on the bottom-right border of the box): 



Configure File Run 



isp lay/A Iter 



Misc Source/Symbols Break/ Trace Help 



■ Modu le : 


TA— 




Asm/Dasm Shift-F4 






F i 1 e : takf 511. aom 






92 




while ( P 


Memory 








93 




U 


Code Alt-F2 








94 




P_H 


Idata Alt-F3 








95 




> /» 


Xdata Alt-F4 








X:00A8 - 


>struct List 




(null) 



C:8000?struct 
C:0000?uint 
C:0802?->stru 
X:0892 13]str 
X:0092 struct 
X:0092 uint 
X:0094 ->stru 
XI0897 struct 
X:0097 uint 
X:0099 ->struct List 
X:009C struct List 
X=009C uint 
X:009E ->struct List 



Express ion : 



=Disp lay/A Iter Express ion- 



Addr: X:0092 Size: 15 bytes 



Type: C3]struct List 



'<expr>" or "<expr> <neu ualue>" 



=Ctr 1-B : Brouse= 



list uiual 7 
list_p_nxt X:0092 
[2] struct List 

list_uival 11 
list_p_nxt X:0097 



U ieu/cha n ge the v alue in any variable, register, bit, memory location, etc. 

HE - 



t EngReset Tg 



oUnti lnSteplnsijStepLinejStepOwriJStepTo 
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Pressing Ctrl-B pops-up a Browse Window, letting us inspect and/or change the individual elements in 
the array: 





92 


uhi le 


<P 


93 


U 




94 


P_ 


li 


95 


> 





Conf igure File 
ule: TA 



Run 2 



i splay /A Iter 



disc Source/Symbols 



Asn/Dasm Shift-F4 
■Memory- 



Code 

Idata 

Xdata 



Alt-F2 
AIt-F3 
Alt-F4 



X:88A8 ->struct List 
C:B888?struct 

c:8eee?uint 

C:B8B2?->stru 
X:8892 [3]str 
X:8892 struct — |X:8B92 
X:8892 uint X:8892 
X:B894 ->stru X:8894 
X:B897 struct l!= X:889? 
X :8897 uint X:8897 
X:8899 ->struct X:8B99 
X.889C struct Li X:889C 
X:B89C uint X:889C 
X:889E ->struct X:8B9E 



Break/ Trace Help 
— File :takf 511 .aon- 



Addr Data Type 



Cnull) 

X:8892 I33struct List nodes= 
Ualue 



:8B92 [31struct List C31struct List 



struct List 
uint 

->struct List 
struct List 
uint 

->struct List 
struct List 
uint 

->struct List 
Ctrl- 



[81 



Uieu/change the value 

12 



in any variable. 



gResetEm«jReset TgJJGo 



struct List 
1 ist_ui val 
1 ist_p_nxt 
struct List 
list_uival 
1 ist_p_nxt 
struct List 
1 ist_u i va 1 
1 ist_p_nxt 
fi: Resize Ctrl-U:Move 
register, bit, 
71^ 



3 

(null) 



111 



[21 



8892 



11 

X:8B97 



loUnt i 1 



memory 

5 ~ 



location, etc. 



tepL inBStepOvrTBtepTo 



You can enter almost any expression in the I)isplay/Alter\Expression dialog box, designating array 
elements and struct/union members just as you would in your C program: 



Configure File 
■ Modu le : TA 



Run 2 



i splay/A Iter 



M i sc Source/Symbo 1 s 



92 
93 
94 
95 



while Cp 
lj 

P_H 
> /* 



X:88A8 ->struct List 
C:88B8?struct 
C:B888?uint 
C:8882?->stru 
X:B892 [3]str 
X:8892 struct 
X:8892 uint 
X:8894 ->stru 
X:8897 struct 
X:B897 uint 
X:8899 ->struct List 
X:B89C struct List 
X:B89C uint 
X:889E ->struct List 



Asm/Dasm Shift-F4 h 

Memory 

Code Alt-F2 ►- 

Idata Alt-F3 ► 

Xdata Alt-F4 ► 



Break/ Trace Help 
— File:takf511 .aom- 



Cnull) 

D i sp 1 ay /A 1 ter Express i on= 
Express ion: nodes [ 1 ] . 1 i st_p_nxt- > 1 i st_u i va 1 



Addr: X:8892 Size: 



2 bytes Type : 
Content 



uint 




Do not change current value 



[21 



list_uival 
1 ist_p_nxt 
struct List 
1 ist_uival 
1 ist_p_nxt 



7 

X:B892 
11 

X:8897 



Uieu/change the value in any variable. 



SjResetEmgReset Tg 



) variable, register, bit, memory location, e t c. 
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Or you can follow a pointer through several levels of indirection in one step: 



Configure File 
■ Module :TA 



Run g 



Misc Source/Symbols 



92 
93 
94 
95 



uhile (p 
U 

P_li 



Break/ Trace Help 
— File:takf511 



Asn/Dasm Shift-F4 ► 
-Memory 



Code 
Idata 
> /* Xdata 



Alt-F2 
Alt-F3 
Alt-F4 



X:B8A8 ->struct List 
C:8888?struct 
C:B888?uint 
C:B882?->stru 
X:B892 C3]str 
X:8892 struct 
X:8892 uint 
X:8894 ->stru 
X:8897 struct 
X:8897 uint 



Expression Alt-F5 



2 (null) 
Display/Alter Expression 



Express ion : 1 ist_head-> 1 ist_p_nxt-> 1 ist_p_nxt 



Addr: X:8899 Size: 3 bytes Type: ->struct List 
Content 



Current: X:8892 



= Esc: Do not change current value Ctr 1-B 

list_uival 7 

X:8899 ->struct List list_p_nxt X:8892 

X:889C struct List [21 struct List 

X:889C uint list_uival 11 

X:889E ->struct List list_p_nxt X:8897 




Uiew/change the value in any variable, register, bit, memory location, etc. 



And, of course, you can also monitor such complicated expressions in the Watch Window. 
Finally, in the simplest case, the £)isplay/Alter\Expression command even operates as a calculator: 



Configure File 
i Modu I e : TA 



Run 3 



isp lay/A Iter 





92 


uhile (p 


93 


U 


94 


P_H 


95 


> /« 



X:88A8 ->struct List J444t.ViW:tiai» 



disc Source/Symbols Break/ Trace Help 
F i le :takf 51 1 . aon- 



Asm/Dasm Shift-F4 ► 
Memory 



Code 

Idata 

Xdata 



Alt-F2 
Alt-F3 
Alt-F4 



(null) 



Hex: 



C:8888?struct 
C:8008?uint 
C:8882?->stru 
X:8892 [31str 
X:8892 struct 
X:8892 uint 
X:B094 ->stru 
X:B097 struct 
X:8897 uint 
X:8899 ->struct List 
X:B89C struct List 
X:B89C uint 
X:889E ->struct List 



=D isp lay/A Iter Express ion= 



Express ion : £ 



Su*bbu 



8x8879 Size: 2 bytes Type: 
Ua 1 ue 



uint 



Current : 121 



'<expr>" or "<expr> <neu ualue>" 



list_uival 7 
list_p_nxt X:8892 
[21 struct List 

list_uival 11 
list_p_nxt X:8897 



Uieu/change the value in any variable, register, bit, memory locatic 



etc . 



esetEm<iResetTg 



ioUnt i lflStepInsjjStepLinHStepOvrEStepTo 
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Source/Symbols Commands 



The Source /Symbols commands display the symbols in your program sorted in various ways. Here we see 
the local symbols in TAKF51LAOM sorted alphabetically within the module in which they were defined: 



Configure File Run Display/Alter M isc 
I Modu 1 e : TA Source- 



otirce/Symbo Is 



Enter Symbo 1 



-Loca 1 Syrabo Is - By Module" 



Break/ Trace Help 
— File: takf 511 .aom , 



CIS Symbols) 



Addr 

C :B8DS 
C : 82?D 
C:8135 
C:81E7 
X:888E 
X:8898 
X:8084 
X:8888 

wm\ 

X:88A5 
X:88A3 
X:88AB 
X:8892 
X:88A8 
•^-Enter : 
I 



Synbo 1 Name 
(M: Module F: Function) 



Chang e- 



Array_Init 
End_Loop 
List_Init 
List_Scan 
ai 
aj 
ary 

iteration 

1 ist_head 
lj 

ma in_loop_f actor 
nodes 
P_l 1st 



Data Type 

(label) 
(label) 
(label) 
(label) 
uint 
uint 

[lBluchar 
float 

->struct List 

uint 

uint 

[3 1st rue t List 
->struct List 



Ualue 



Defined Within 
(It: Scope Leuel) 



10 

21 

[lBluchar 
5.5 



MAIN 
MAIN 
MAIN 
MAIN 
MAIN 
MAIN 
MAIN 
MAIN 



3 2 MAIN 



X:809C 2 MAIN 

2 2 MAIN 

3 2 MAIN 
[31struct List 2 MAIN 

(null) 2 MAIN 



Ctrl-R:Resize Ctrl-U:Move 



J 



Source leuel debug and symbol displays 



All of the Source /Symbols windows have the same basic format, showing the address of the symbol, the 
symbol's name, its data type, current value and where it was defined in the program. As you scroll through 
the window, the EntenChange prompt appears on the bottom-left border of the window if you can change 
the currently highlighted item. This is the case for scalars (integral and floating-point) and pointers. 
Pressing Enter while // is highlighted pops up a Change Box to allow you to change its current value: 



Configure File Run Display/Alter Misc 
I Modu 1 e : TA Source- 



lOiirce/Synbo Is 



Break/ Trace He 1 p 
— File:takf511 .aom- 



Enter Symbol 



-Loca 1 Symbo Is - By Module- 



CIS Symbols) 



Symbo 1 Name 
Addr (M:Module F:Function) 



Array_Init 
End_Loop 
List_Init 
List_Scan 




Data Type 

(label) 

(label) 

(label) 

(label) 

uint 

uint 

[lBluchar 
float 



Ualue 



IB 

21 

[lBluchar 
5.5 



Change Ualue (Content) 

Size: 2 bytes Type: uint 
Content 



Do not change current ualue 



Defined Uithin 
(«: Scope Leuel) 



MAIN 
MAIN 
MAIN 
MAIN 
MAIN 
MAIN 
MAIN 
MAIN 



3 2 MAIN 



X:B89C 2 

2 2 

3 2 
ruct List 2 

(null) 2 



MAIN 
MAIN 
MAIN 
MAIN 
MAIN 



Source leuel debug and symbol displays 
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If a symbol is an array, structure or union, the "value" shown in the Source / Symbols windows is the 
symbol's data type: 



Configure File 
I Modu 1 e : TA 



Run Display/Alter disc 
Source- 



Break/ Trace Help 
— File :takf 511 



Enter Symbol 



-Loca 1 Symbo Is - By Module" 



(15 Symbols) 



Symbol Name 
Addr (H:ModuIe F:Function) 



Data Type 



Mai ue 



Defined Uithin 
(It: Scope Leuel) 



C:00D9 


Array_Init 


(label) 






2 


MAIN 


C:B27D 


End_Loop 


(label) 






2 


MAIN 


C:8135 


List_Init 


(label) 






2 


MAIN 


C:B1E7 


List Scan 


(label) 






2 


MAIN 


x:eeoE 


ai 


uint 




10 


2 


MAIN 


X:8890 


aj 


uint 




21 


2 


MAIN 


K:0884 


ary 


[ 18 luchai 




[101ucliar 


2 


MAIN 


X:8888 


iteration 


float 




5.5 


2 


MAIN 


X:88A1 


li 


uint 




3 


2 


MAIN 


X:80A5 


1 ist head 


->struct 


List 


X:809C 


2 


MAIN 


X:88A3 


lj 


uint 




2 


2 


MAIN 


X:08AB 


ma i n_ loop_f actor 


u int 




3 


2 


MAIN 


X:8892 


nodes 


[3)struct List 


L3 Istruct List 


2 


MAIN 


X:88A8 


P_l ist 


->struct 


List 


(nul 1) 


2 


MAIN 



Ctrl-R:Resize Ctrl-U:Moue 



-Ctrl-B:Browse= 



level debug and symbol displays 



Notice that the CtrI-B:Browse prompt appears on the bottom-right border of the window. You can browse 
(inspect) structures, unions, arrays and pointers in all the Source / Symbols windows. Pressing Ctrl-B here 
pops up a Browse Window, allowing us to inspect the individual elements in the array ary: 



Conf i gure File 
I Modu 1 e '. TA 



Run Display/Alter Misc 
Source- 



lource/S 



-Local Symbols - By Module- 



Addr Data Type 



=X:8884 (181 uchar ary= 
Value 



=Ctrl-U:Uri 



X:B884 
X:8B84 
X:8885 
X:8886 



[lBIuchar 
uchar 
uchar 
uchar 



[ 10 luchar 
[ 8] 0x83 
[ 1) 8x85 
[ 21 8x87 



:0087 uchar 



I 31 8x09 ' 



X.-0888 
X:8889 
X:008A 
X:888B 
X:888C 
X:888D 
Enter 
X:80A3 
X:80AB 
X:0092 
X:88A8 



uchar 
uchar 
uchar 
uchar 
uchar 
uchar 

Change— Ctr 
lj 

main_loop. 
nodes 
p_l ist 



3 
5 
7 

pa 

[ 41 8x0B ' .' 11 
[ 5] 0x0D 1 .' 13 
[ 61 0x0F ' .' 15 
[ 71 0x11 ' .' 17 
[ 81 0x13 ' .' 19 
I 91 0x15 ' .' 21 
1-R: Resize Ctr 1-V: Move - 
uint 

_f actor uint 

[3 Istruct List 
->struct List 
Ctrl-R:Resize Ctrl- 



Break/ Trace Help 
— Fi le:takf511 .aom , 



Defined Within 
It: Scope Leuel) 



(15 Symbols) 



2 2 

3 2 

C3 Istruct List 2 
(null) 2 
U:Move 



MAIN 
MAIN 
MAIN 
MAIN 
MAIN 
MAIN 



MAIN 
MAIN 
MAIN 
MAIN 
MAIN 
MAIN 
MAIN 

=Ctrl-B:Brouse= 



Source leuel debug and symbol displays 
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Similarly, if the currently-highlighted symbol is a pointer to something, we can press the Ctrl-B key to 
browse that "something". And, of course, if that "something" contains elements that are browseable, we 
can inspect or change them, too: 



Configure File 
I Modu le : TA 



Run 



Display/Alter Misc 
Source- 



L ocal Symbols - By Modu le- 
=X:B8A5 ->struct List list head .1 



Break/ Trace Help 
— Fi le:takf511 .aon , 



Addr 



X:8B9C 
X:B89C 



=X:889E ->struct List= 



C15 Symbols) 



Addr 



X:8897 
X:8897 

mm 



C:88D9 
C : B27D 
C:8135 
C:81E7 
X:B88E 
X:8898 
X:8884 
X:8888 
X:88A1 

a 

X:88A3 



Addr 



=X : mSS ->struct List= 
Data Type Ualue 



X:B892 struct List 
X:B892 uint 

"=Enter 

Arr >M5nter : Change 3 



:0B94 ->struct Li; 



struct List 
1 ist u i ua 1 



1 ist_p_nxt Cnu 11) 



=Ctr 1-B : Brouse=4 



End Loop 

List_Init 

L ist_Scan 

ai 

aj 

ary 

iteration 

li 



(label) 

(label) 

(label) 

uint 

uint 

[ 18 Juchar 
float 

uint 



•>struct List 



IB 

21 

[lBluchar 

5.5 
3 



Defined Within 
(Jt: Scope Level) 



1 TA 



MAIN 
MAIN 
MAIN 
MAIN 
MAIN 
MAIN 
MAIN 
MAIN 
MAIN 



X:BB9C 2 MAIN 



Change- 



uint 

Ctrl-R: Resize Ctrl-V:Move 



2 2 MAIN 

Ctr 1-B : Browse* 



Source level debug and symbol displays 
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Improved Support for "Unsupported" Programs 



Even if your program contains limited data type information, or no data type information at all, you can 
still benefit from some of the new features in the iceMASTER software. 

The demo program DEMO.DBG is an assembly language program assembled using MetaLink's 8051 
cross-assembler. The only debug information output by this assembler (and many other assemblers, too) 
is symbol name, address and memory space (e.g., Code memory, External Data memory, etc.). There is 
no data type information. 



Configure File 



Display/Alter Misc Source/Symbols 
Source 



0830 980090 START: MOU 
8833 C290 OUTERLOOP : CLR 
0035 75640A MOU 



DPTR.H0000H 
T2 

TEMPCOUN T , tt 0Ah 



Break/ 1 Trace Help 

F i le : demo .dbg 1 

DPTR=88B8h 
bitl90hj=l 
direct [64hl=88h 



038 120850 INNERLOOP: LCALL UASTETIME 



B83B B298 
003D E4 
083E 389801 
0841 F4 

0042 D564F3 SKIPOUER: 

0845 A3 

0846 128858 
8849 128858 
084C 88E5 

084E 88E8 EHDOFPROGRAM ! 
0858 78FF UASTETIME: 



CPL T2 
CLR A 

JMB 12, SKI POWER 
CPL A 

DJNZ TEMPCOUN T, INMERLOOP 

INC DPTR 

LCALL UASTETIME 

LCALL UASTETIME 

SJMP OUTERLOOP 

SJMP START 

MOU R8,ttBFFh 

Uatch- 




B egin em u lation 



CurMod 



■SoUiit i 1 



StepLin9StepO«r8S 



ymAlpJi 
tepTo 



In the picture above, we have loaded DEMO.DBG into the emulator and added the Watch Expression 
TEMPCOUNT to the Watch Window. Notice that the data type is "(unknown)". In such cases, the host 
software defaults to displaying the value in hexadecimal only, and the software must be "told" how many 
bytes to read (via the Configure \ Options \Expressions \ Unknown data type size command). Below, we are 
about to add a Watch Expression that will cause the host software to treat TEMPCOUNT as "true" 
one-byte unsigned character value. 

23J3E323 File Run Display/Alter Misc Source/Symbols Break/Trace Help 



Emu 1 ator 

■Mapp i ng- 
Code Memory 
Xdata Memory 
Mode 

— Display- 
Attr ibutes 



ttl ► 



Modify Ctrl-F6 
Size Ctrl-F7 
Goto Ctrl-F8 
Repai nt Alt-Fl 



-Source- 



MOU DPTR.S8880H 
CLR T2 

MOU TEMPCOUNT ,88Ah 
LCALL UASTETIME 



-F i le : demo .dbg 1 

DPTR=0000h 
bitI90hl=l 
direct [64hl=00h 



CPL 
CLR 
JNB 
CPL 



T2 
A 

T2, SKIPOUER 
A 



DJNZ TEMPCOUNT, INNERLOOP T8038 direct[64hl=0A}i 



D:0064 



dd Ctrl-F9 ► 



INC 

LCALL 

LCALL 

SJMP 

SJMP 

MOU 



DPTR 

UASTETIME 
UASTETIME 
OUTERLOOP 
START 
R8 , JtBFFh 



R0=64h 



"Add Uatch Expression- 



uchar) TEMPCOUNT 



Load 



E nter an y expres s ion den o ting an address . 
si^W^B re»;tTi» Hf'Vffl "JM;M--M ,HJaW-M CurMod 
1| 
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As you can see below, there isn't much difference in the display in this case: 



File Run Display/Alter Misc Source/Symbols Break/'Trace Help 
Source F lie: demo . dbg- 



8838 


988888 


START : 


MOM 


DPTR,tt8888H 


DPTR=8BB8h 


8833 


C298 


OUTERLOOP : 


CLR 


T2 


bit[98hl=l 


8835 


75648A 




MOV 


TEMPCOUNT, *8Ah 


direct [64hl=B8h 


8838 


128858 


INNERLOOP: 


LCALL 


UASTETIME 


18858 


883B 


B298 




CPL 


T2 




883D 


E4 




CLR 


A 




883E 


389881 




JNB 


T2.SKIP0UER 




8841 


F4 




CPL 


A 




WB42 


DS64F3 


SK1POUER: 


DJMZ 


TEMPCOUNT, INNERLOOP 


TM838 direct[£>4hl=0Ah 


8845 


A3 




IMC 


DPTR 




8846 


128858 




LCALL 


UASTETIME 




8849 


128858 




LCALL 


UASTETIME 




884C 


88E5 




SJMP 


OUTERLOOP 




B84E 


88E8 


ENDOFPROGRAM ! 


SJMP 


START 




8858 


78FF 


UASTETIME: 


MOU 


R8,tt8FFh 


R8=64h 















D:8864 (unknown) 
D:8864 uchar 



TEMPCOUNT 
(uchar) TEMPCOUNT 



8x8A 
8x8A 



18 



S et up t h e system configuration 



auSrc BSymGlob 



JtepL in9Step0ur£ 



but the Watch Expression (uchar)TEMPCOUNT will not be effected by changing the value for the 
Configure \ Options \ Expressions \ Unknown data type size command. The host software will always readjust 
one byte and treat that byte as an unsigned character value. 

What if the program is manipulating a 16-bit value at address 0x0050 in External Data memory (high byte 
at 0x0050, low byte at 0x0051) and there is no symbol associated with that location? Here we are about 
to add a Watch Expression that will let us monitor that value: 



File Run Display/Alter Misc Source/Symbols Break/Trace Help 



Emulator 

Mapp ing- 
Code Memory 
Xdata Memory 
Mode 

— Display- 
Attributes 



indous 



81 ► 



Modify Ctrl-F6 
Size Ctrl-F7 
Goto Ctr 1-F8 
Repai nt Alt-Fl 

"swan 



-Sou re e- 



MOO DPTR,tt8888H 
CLR T2 

MOU TEMPCOUNT, »8Ah 
LCALL UASTETIME 



-File: demo . dbg 1 

DPTR=8888h 
bit[98Ji]=l 
direct [64h]=88h 



CPL 
CLR 
JNB 
CPL 



T2 
A 

T2.SKIP0UER 
A 



DJNZ TEMPCOUNT, INNERLOOP TBH38 direct [64h]=8Ah 



INC 



D:8864 
D:8B64 



dd Ctrl-F9 ► 



DPTR 
LCALL UASTETIME 
LCALL UASTETIME 
SJMP OUTERLOOP 
SJMP START 
ImOO R8,*8FFh 



R8=64h 



-Add Watch Expression- 



(uint)x:58h 



Load 



1 
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E nter an y expression den o ting an address ■ 

s iBSB^ > 'Si!lffii_. k, IMJ'i < t!l ilESi curHod g 



auSrc ■SymGIobySymAlpli 
tepTo 



StepL in9Ste P 0urBa 
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After the Watch Expression (uint)x:50h is added, the host software will monitor the two bytes starting at 
location 0x0050 in External Data memory and treat those two bytes combined as a 16-bit unsigned integer 
value. The default display format for such values is (unsigned) decimal notation, although you can change 
that to your choice of character, decimal or hexadecimal notations using the Configure \ Options {Expres- 
sions \int/uint command: 



Configure File iiTBT 



Display/Alter disc Source/Symbols 
Source 



Break/ Trace Help 
-File: demo . dbg 1 



0838 


900000 


START: 


MOU 


DPTR,*8888H 


DPTR=0000h 


0833 


C290 


outerloop: 


CLR 


T2 


bitC98h]=l 


8835 


7564BA 




MOU 


TEMPCOUNT , ttBAb 


direct [64hl=00h 


8838 


120050 


INNERLOOP: 


LCALL 


UASTETIME 


18050 


083B 


B290 




CPL 


T2 




B83D 


E4 




CLR 


A 




883E 


309001 




JNB 


T2, SKIPOUER 




8841 


F4 




CPL 


A 




10042 


D564F3 


SKIPOUER: 


DJNZ 


TEMPCOUNT, INNERLOOP 


T0038 direct[64hl=8Ah| 


8845 


A3 




INC 


DPTR 




0846 


120050 




LCALL 


UASTETIME 




0049 


120050 




LCALL 


UASTETIME 




084C 


80E5 




SJMP 


OUTERLOOP 




804E 


88E8 


ENDOFPROGRAM : 


SJMP 


START 




0858 


78FF 


UASTETIME: 


MOU 


RB,*8FFh 
1,1, + ,-v. 


R8=64h 



D:0064 (unknown) 
D:0864 uchar 
X : 0050 uint 



TEMPCOUMT BxBA 
(uchar) TEMPCOUNT BxBA ' 

(uint)x:58h 65535 
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Begin emulation 



^tepL in9Step0vr8£ 



ymG 1 ob£ISymA 1 pli 
tepTo 



With the ability throughout the host software to specify addresses using expressions rather just simple 
labels or absolute addresses, you can, for example, set break-points relative to a label: 



Configure File Run Display/Alter Misc Source/Symbols Break/ Trace Help 

Break-Points & Trace-On/Off 



Add Remove HBtW Numeric Symbolic Opcode_Class Load Save Uindou 



ADD 



Start Address 
End Address 



= (Hex or Symbol ic) = 
Ctrl-R:Resize Ctrl-U:Moue Tab , Shift-Tab : Select 



8841 


F4 




CPL 


A 


ACC=88h 


8842 


D564F3 


SKIPOUER: 


DJNZ 


TEMPCOUNT, INNERLOOP 


T8838 direct C64hl=89h 


8845 


A3 




INC 


DPTR 


DPTR=8B80h 


8846 


128858 




LCALL 


UASTETIME 


10050 


8849 


128858 




LCALL 


UASTETIME 


4.0050 


8B4C 


80E5 




SJMP 


OUTERLOOP 




004E 


88E8 


ENDOFPROGRAM : 


SJMP 


START 




0058 


78FF 


UASTETIME : 


MOU 


RB, JtBFFh 


RB=BBh 


B852 


D8FE 




DJNZ 


R8,8852h 


*8852 R8=E9hl 


8854 


22 




RET 




ret addr=883Bh 


8855 


FF 




MOU 


R7.A 




0056 


FF 




MOU 


R7.A 




0857 


FF 




MOU 


R7,A 




8858 


FF 




MOU 


R7,A 





Edit address range 



This is handy if you have a multi-module assembly language program and are using the assembler- 
generated listing files to set break-points. The listings contain addresses relative to the beginning of the 
module, not the final, absolute addresses in the bound (linked) program. 
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You can also set a break-point range based only on a "starting point" and a "distance", without having to 
compute the start and end points manually: 



Configure File Run Display/Alter Hisc Source/Symbols Break/Trace Help 

Break-Points 8 Trace-On/Off 



Add Remove URtH Numeric Symbolic Opcode _C lass Load Save Uindow 



CBREAK 



ADD 
88 



Start Address s 
End Address ! 

(Hex or Symbol ic)= 



tart 

tart*4Bli 



Ctrl-R '.Resize Ctrl-U:Houe Tab,Shift-Tab:Select 



8841 


F4 




CPL 


A 


ACOBBh 


8842 


D564F3 


skipomer: 


DJHZ 


TEHPCOUHT, IHNERLOOP 


t0038 direct [64hl=B9h 


8845 


A3 




INC 


DPTR 


DPTR=8880h 


8846 


128858 




LCALL 


UASTETIHE 


48858 


8849 


128858 




LCALL 


UASTETIHE 




884C 


88E5 




SJNP 


OUTERLOOP 




884E 


88E8 


ENDOFPROGRAH : 


SJHP 


START 




8858 


78FF 


UASTETIHE: 


NOU 


R8,*8FFh 


R8-B8h 


10052 


D8FE 




DJNZ 


RB, 8052h 


*8852 R8=E9hl 


8854 


22 




RET 




ret addr=883Bh 


8855 


FF 




NOU 


R7.A 




8856 


FF 




MCKJ 


R7,A 




8857 


FF 




NOU 


R7,A 




8858 


FF 




NOU 


R7.A 





Edit address range 



You can specify ranges in the same way throughout the host software, no matter what you are doing: 



Configure File Run 



isp lay/A Iter 



H i sc Source /Symbo 1 s 
-Source 



8838>>98B88B START: 
B833*C298 OUTERLOOP : 
BB35^75648A 
B838K 128858 INNERLOO 
B83B>>B298 
883D^E4 
B83F>389881 
8841>-F4 

8B42KD564F3 SKIPOUER 
0845KA3 
8846K 128858 
8849^128858 
884CK88E5 

884F>88E8 ENDOFPRO 
B858K78FF UASTETIH 



MOU 
CLR 
HOU 



Ur ite 




B52KD8FE 



0854*22 
8855>-FF 
8856KFF 
B857*FF 
8858*FF 



DPTR.ttBBBBH 
T2 

TEHPCOUNT,*BAh 
•U ieu/C hange Code Hemory= 
Houe Compare 
Fi 11- 



8888 
8808 
8818 
8818 
8828 
8828 
BB30 
8838 



82 
FF 

FF FF FF FF FF 
FF FF FF FF FF 
FF FF FF FF FF 
FF FF FF FF FF 
98 88 88 C2 98 
12 88 58 B2 98 
= Ctrl-R: Resize 



=Esc : Cancel = 
FF FF FF 
FF FF FF 
FF FF FF 
FF FF FF 
75 64 8A 
E4 38 98 



Break/ Trace Help 

F i le : demo . dbg — 

DPTR=8888h 
bit[98hl=l 
direct [64hl=85h 
18858 
bitC98hl=l 
ACC=FFh 
bitC98hl=8 
ACC=88h 
t[64hl=89h 
DPTR=B008h 
18858 
18858 



.P. 



.ud. 
. .8. 



Ctrl-U:Houe = 



R8=88h 



^8852 R8=E91i 



ret addr=883Bh 



HOU 
HOU 
HOU 
HOU 



R7.A 
R7,A 
R7.A 
R7,A 



Fill a block of Code memory 
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Chapter 3: Reference 



Expression Input 



Whenever and wherever the iceMASTER host software requests an address, count or length, you can 
enter an arbitrary expression (suitable for the particular context, of course). Expressions are composed 
of the following elements. 

Identifiers 



The first character in an identifier name cannot be a digit or the '$' character: 

First character: ? @ a-z A-Z 

Subsequent characters: _ $ a-z A-Z 0-9 



Constants 



Integer Constants 



iceMASTER supports C-style constants as well as a variety of other popular formats. The following 
notations are used in subsequent definitions. A plural suffix (j) means "one or more of" the specified 
characters or digits. A suffix of -opt means that the item is optional (i.e., "zero or more of). 



hex-digit: 0-9 a-f A-F 

dec-digit: 0-9 

non-zero-dec-digit: 1-9 

oct-digit: 0-7 

bin-digit: 0-1 



Explicit Radix The following constants contain an explicit radix (base) designator, either as a prefix or a suffix. Such 
constants will always be interpreted in the designated base, regardless of the current setting of the 
£onfigure\Qptions\Expressions\Radix command (see page 3-15). Following each definition are some 
examples of that particular style of constant. 

Ox hex-digits 
OX hex-digits 

Hexadecimal constant with explicit prefix (C style). 

An optional suffix of 'u' or 'U' specifies an unsigned integer. This is generally unnecessary, as the host 
software treats all constants as unsigned. 

An optional suffix of T or 'L' specifies a long (32-bit) integer rather than a 16-bit integer. 
The suffixes 'u'/'lP and T/'L' can be used at the same time, in either order. 

0x12 
Oxa 

0x12751 
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X' hex-digits 

Hexadecimal constant with explicit prefix (NSC style). 

x'ab 
x'45 

x'123456 
$ hex-digits 

Hexadecimal constant with explicit prefix (Motorola style). 

$ab 

$0045 

$123456 

dec-digit hex-digits-opt h 
dec-digit hex-digits-opt H 

Hexadecimal constant with explicit suffix (Intel, et. al., style). 

lah 

0054b. 

12345678h 

dec-digits t 
dec-digits T 
dec-digits . 

Decimal constant with explicit suffix. 

12t 
045. 

non-zero-dec-digit dec-digits-opt u 
non-zero-dec-digit dec-digits-opt U 
non-zero-dec-digit dec-digits-opt 1 
non-zero-dec-digit dec-digits-opt L 

Decimal constant with explicit "suffix" (C style). 

A suffix of 'u' or 'U' specifies an unsigned integer. This is generally unnecessary, as the host software 
treats all constants as unsigned. 

A suffix of T or 'L' specifies a long (32-bit) integer rather than a 16-bit integer. 
The suffixes 'u'/'U' and T/'L' can be used at the same time, in either order. 

5u 

231 

47ul 
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oct-digits o 
oct-digits O 
oct-digits q 
oct-digits Q 

Octal constant with explicit suffix. 

12o 
045o 

oct-digits 

Octal constant with explicit prefix (leading zero, C style). 

An optional suffix of 'u' or 'U' specifies an unsigned integer. This is generally unnecessary, as the host 
software treats all constants as unsigned. 

An optional suffix of T or %' specifies a long (32-bit) integer rather than a 16-bit integer. 
The suffixes 'u'/'U' and T/'L' can be used at the same time, in either order. 

012 
055u 

bin-digits y 
bin-digits Y 

Binary constant with explicit suffix. 

lOlly 
011101Y 

In all cases, if you do not supply an 'I' or 'L' suffix (or if such a suffix is not allowed) and the constant 
cannot fit in 16 bits, it will automatically be treated as a long value (32 bits). 

If you are unsure of how a particular constant is being interpreted by the host software, just use the 
Display /Alter\Expression command (page 3-25) to see how the constant or constant expression is being 
treated. 

No If you enter a number such as 10 or 101, it will be interpreted in the current default radix (base) as 

Explicit Radix specified by the (Configure \Qptions \Expressions \Radix command (see page 3-15). However, in certain 

contexts where it makes sense, the host software will temporarily override the current default. For 

example, when you enter a source line number as 

#11 

the software temporarily changes the default radix to 10 (decimal) before translating the '11'. In other 
cases, when the software displays a Dialog Box to obtain input, a prompt somewhere in the box (usually 
on the bottom border) indicates if the default radix has been changed temporarily. 

In any case, you can always provide an explicit radix designator in the constant to override any default 
interpretation. For example, '#0x23' designates source line number 35 decimal, as does '#35t'. 

In some cases, the software can automatically determine the appropriate radix based only on the 
characters and digits present in the constant. For example, 1 A can only be the hexadecimal number OxlA, 
even though no explicit prefix or suffix is present. 
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Floating-Point Constants 



The software supports both single-precision and double-precision floating-point constants. 

dec-digits . dec-digits exponent-opt 
dec-digits exponent 

The exponent has the following form: 

exponent: exp-char sign-opt dec-digits 
exp-char. e or E 
sign: + or - 

If there is no suffix, the constant is double-precision floating-point (double). An optional suffix of T 
or 'F' specifies that the constant is single-precision floating-point (float). An optional suffix of T or 
'L' explicitly specifies explicitly that the constant is double-precision floating-point (double). 

Unlike C, "1." is not a valid floating-point constant. You must always supply at least one digit after 
the decimal point (e.g., "1.0"). 

1.2 

1.2f 

5.6e5 

Character Constants 



The value of a character constant is the numerical value of the character interpreted as an integer. 
Internally, character constants are treated just as if you had entered an integer constant. 

'\ l-to-3-oct-digits ' 
'\\ l-to-3-hex-digits ' 
'\ escaped-char ' 
' char ' 

The first form uses an escaped sequence of one to three octal digits. 

The second form uses an escaped sequence of one to three hexadecimal digits. 

The third form specifies one of the following specially recognized escape characters: 



.Source Form 


p 

Internal Value Meaning 


\a 


0x07 


ANSI alert (bell) 


\b 0x08 


ANSI backspace 


\e 


OxlB 


ANSI ESC 


V 


OxOC 


ANSI Formfeed 


\n 


OxOA 


ANSI New line 


V 


OxOD 


ANSI Carriage return 


\t 


0x09 


ANSI Horizontal tab 


\v 


OxOB 


ANSI Vertical tab 
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If the backslash precedes a character that does not appear in the table above, the value used is 
the value of that character itself. That is, '\vf is the same as 'w". 

The fourth form represents the standard, "simple" case. 

'\077' 
'\xAB' 

'W 

'H' 

String Constants 



" chars-opt " 

The form of each char in chars-opt is the same as that allowed for character constants. That is, all 
forms of escape sequences are allowed internally. 

Currently, string constants can only be used as fill values in the Display/Alter] (memory) \FilI 
commands. 

Expressions 



The operators and operands which are allowed in expressions are grouped below in decreasing prece- 
dence (priority) order. The highest precedence operators and expression elements are listed first. To 
simplify the description, the term expr means any expression at that precedence level or higher, and the 
term expression means any expression at all. 

Primary identifier 

Denotes a variable, label, module, function or SFR (Special Function Register) name. In the absence 
of any qualification on identifier, the software searches for the definition in the following order: 

- local symbols in the current module 

- global symbols 

In the following descriptions, we use more meaningful names for identifiers to denote what kind of 
identifier is required in a particular context: 

- module-name 

- function-name 

- SFR-name 

constant 

An integer constant, floating-point constant or character constant. 
string 

A character string constant (literal). 
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( expression ) 



A parenthesized expression. Parentheses can be used to change or clarify the order of operator 
precedence. 

# integer-constant 

Source line number 'integer-constant' in the current module. 
module-name : # integer-constant 

Source line number 'integer-constant' in the module module-name, 
module-name : identifier 

Local variable or function identifier in module module-name, 
module-name : function-name : variable-name 

The local variable variable-name in the function function-name in module module-name. 

C : integer-constant 
X : integer-constant 
D : integer-constant 
I : integer-constant 
B : integer-constant 

Denotes a memory-space qualified constant. In most cases where the host software requests an 
address, you do not need to specify explicitly what memory space to use when you enter a constant 
or constant expression. For example, when setting a Code Memory break-point, if you enter 0x23, 
the host software assumes that you mean location 0x0023 in Code Memory. Similarly, if you use labels 
or variable names, the symbol/debug information supplied in the program load module file normally 
tells in which memory space that symbol belongs. 



However, if you want to change the value in a generic pointer (see page 3-13), you must tell the host 
software the memory space in which the address exists (which memory space the address is relative 
to). 



Designator 


Memory Space 


Applicability 


MCS-51 


COP8 


68HC11 


68HC05 


C 


Code 


X 


X 


X 


X 


D 


Directly-addressable 
Internal Data 


X 


X 






I 


Indirectly-addressable 
Internal Data 


X 








X 


External Data 


X 








B 


Bit-addressable 
Internal Data 


X 









You can use a memory-space qualified constant to designate an address in other contexts, too. For 
example, in a program with no symbolic debug information, you can add the Watch Expression 
X:0x23 to the Watch Window. This will allow you to monitor location 0x0023 in External Data 
memory. 
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Examples: 

X:0x23 designates location 0x0023 in External Data memory 

D:45h designates location 0x45 in Directly-addressable Internal Data/RAM memory 
expr . member-name 

Structure or union member member-name in the struct/union expression expr. The expr must have 
a struct or union type. 

expr . integer-constant 

(MCS-51 only) Designates a particular bit in a bit-addressable SFR. integer-constant must be between 
and 7, inclusive. 

expr -> member-name 

Structure or union member member-name in the struct/union pointed at by pointer expression expr. 
The expr must have the type "pointer to struct" or "pointer to union". 

expr [ expression ] 

Subscript expression. The entity being subscripted, expr, must have type "array of ..." or "pointer to 
The subscript expression, expression, must be of an integral type. 

* expr 

Indirection through pointer expression expr, which must be of a "pointer to ..." type. 
- expr 

Unary minus. The expr can be either integral or a floating-point constant. 
+ expr 

Unary plus. The expr can be either integral or a floating-point constant. 
( type-name ) expr 

Casting is intended for use in conjunction with a memory-space qualified constant (an address). The 
meaning of such an expression is "treat the location expr as having data type type-name". 

The available type-names, which are reserved words, are: 
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. . 




Memory Layout 


bit 


bit 


1 bit 




char 


char 


1 byte 




uchar 


unsigned char 

UllOlOlvU vllUI 


1 byte 




short 


short 


2 bytes 


MSB, LSB 


ushort 


unsigned short 


2 bytes 


MSB, LSB 


int 


int 


2 hvtps 


MSB LSB 


uint 


unsigned int 


2 bytes 


MSB, LSB 


mug 


lontr 


4 bytes 


MSW LSW Teach MSB LSB1 


ulong 


unsigned long 


4 bytes 


MSW, LSW (each MSB, LSB) 


float 


float 


4 bytes 


IEEE single-precision floating-point 


double 


double 


8 bytes 


IEEE double-precision floating-point 



MSB: Most Significant Byte (8 bits) 

LSB: Least Significant Byte (8 bits) 

MSW: Most Significant Word (16 bits, 2 bytes) 

LSW: Least Significant Word (16 bits, 2 bytes) 



Note that jio conversions are performed on the value itself. The cast merely changes the data type 
that the host software associates with the designated address expression. 

Multiplicative expr * expr 

Multiplication. 
expr I expr 

Division. 
expr % expr 

Modulo division. 
Additive expr + expr 

Addition. 
expr - expr 

Subtraction. 




Display Formats 



This section describes the display formatting conventions used by the host software. 

Addresses 

Addresses displayed in the following contexts 

■ Watch Window 

■ Display/Alter {Expression command 

■ Source/Symbols \Address command 

■ Source/Symbols \Alpha command 

■ Source/Symbols \ Global command 

■ Source/Symbols \ Local command 

■ Pop-up Change Box 

■ Pop-up Browse Window 

are of the form: 
m-Jihhh 

where m is a character denoting the memory space and hhhh is the hexadecimal offset into that memory 
space. The possible values of m are: 



Designator 
in 


Memory Space 


Applicability 


MCS-51 


COPS 


68HC11 


68HC05 


C 


Code 


X 


X 


X 


X 


D 


Directly-addressable 
Internal Data 


X 


X 






I 


Indirectly-addressable 
Internal Data 


X 








X 


External Data 


X 








B 


Bit-addressable 
Internal Data 


X 








N 


(none / any / "number") 


X 


X 


X 


X 
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Type Names 



Fundamental Types 



Displayed 
Type Name 


C Data Type 


Size (Memory Layout) 


(unknown) 


_ 


Configure \ Options \ Expressions \ Unknown data type size 
(see page 3-16) 


(untyped) 




bit 


bit 


lbit 


char 


signed char 


lbyte 


uchar 


unsigned char 


lbyte 


short 


signed short 


2 bytes (MSB, LSB) 


ushort 


unsigned short 


2 bytes (MSB, LSB) 


int 


signed int 


2 bytes (MSB, LSB) 


uint 


unsigned int 


2 bytes (MSB, LSB) 


long 


signed long 


4 bytes (MSW (MSB, LSB), LSW (MSB, LSB)) 


ulong 


unsigned long 


4 bytes (MSW (MSB, LSB), LSW (MSB, LSB)) 


float 


float 


4 bytes (IEEE format) 


double 


double 


8 bytes (IEEE format) 


void 


void 




(label) 


(statement label) 





Bit Field Types 



The type name displayed for structure members which are C bit fields shows the underlying integral type 
preceded by the bit offset into an object of that type and the number of bits in the field. The general format 
is: 

offset:length Jype-name 

where 'offset' is the offset to the least significant bit in the field, 'length' is the field length (in bits) and 
type-name is the name of the underlying type. The offset 'offset' is zero-relative, starting at the least 
significant bit. For example, the bits in a char are numbered 7,...,0, with 7 being the most significant bit 
and being the least significant bit. 

See page 3-18 for an example of the display of a structure containing bit field members. 
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Derived/Aggregate Types 



The general display formats are as follows, where represents any data type name: 



Display Format 





->... 


"pointer to ..." 


[n]... 


"array of n ..." 


0- 


"function returning ..." 


struct tag-name 


(structure with tag name tag-name) 


struct 


(structure with no tag name) 


union tag-name 


(union with tag name tag-name) 


union 


(union with no tag name) 



Unlike C, where data types read "from the inside out, obeying the parentheses", the data type names 
displayed by the host software read strictly from left-to-right: 



Displayed 
Type Name 


Example C Declaration 


Data Type 


->int 


int* pi; 


"pointer to int" 


[5]int 


int x[5] 


"array of 5 ints" 


()int 


int f(); 


"function returning int" 


[15]->int 


int* y[15]; 


"array of 15 pointers to int" 


->()-> [10]- > char 


char* (*(*abc)())[10]; 


"pointer to a function returning a pointer 
to an array of 10 pointers to char" 



Values 

The display format of a value depends on that value's data type. 

Fundamental Types 

You can display values of the fundamental types in one of three formats: 

a) Character (enclosed in apostrophes (')) 

b) Decimal (signed or unsigned) 

c) Hexadecimal 

You control the display format for a particular data type with commands in the Configure \ Options \ Ex- 
pressions pull-down menu (see page 3-20). 
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Pointers 



The display format of a pointer value depends on the "nature" of the pointer. 

Generic pointers are needed due to the Harvard architecture of the MCS-51. A generic pointer occupies 
three bytes in memory. The first byte contains a selector value/code denoting which memory space is 
being referenced (e.g., Code memory, External Data memory, etc.). The next two bytes contain the offset 
(OxOOOO-OxFFFF) into that memory space. 

A generic pointer is used when the compiler does not know (at compile-time) what memory space a 
pointer variable may reference. 

The general display format for a generic pointer is: 



where m is a character denoting the memory space and hhhh is the hexadecimal offset into that memory 
space. The possible memory space characters (m) are a subset of those listed in the table on page 3-10. 

The display format for invalid (illegal, erroneous) generic pointers is: 

1Mxhh{sshhhh) 

An invalid generic pointer value is one with an illegal memory space selector byte value. This can occur 
for several reasons: 

1) The application program has not yet initialized (assigned to) the pointer. 

2) The application program has erroneously "clobbered" (written to) the memory space selector byte 



value in the pointer. 

3) The linker has assigned (static) variables to memory locations so that local variables in functions 
which cannot be active at the same time share the same memory for their local variables. For 
example, if functions 'a' and 'b' can never be active at the same time, the linker may assign the local 
variables in function 'a' such that they use the same memory locations as the local variables in 
function 'b'. If function 'b' is currently active and you display a local pointer variable defined in 
function 'a', the value in that pointer variable may appear to be "bad". 

Memory-specific pointers are used when the compiler "knows" at compile-time what memory space is 
being referenced by a particular pointer. Memory-specific pointers occupy only the number of bytes 
required to hold an address spanning a particular memory space. Memory-specific pointers do not 
contain a memory space selector byte. 

The general display formats for memory-specific pointers are: 



where m, hh and hhhh are the same as for the generic pointers. The memory space designator m is 
included to let you know which memory space is being referenced by the offset value hh or hhhh. It is 
enclosed in parentheses to let you know that the memory space is implicit (i.e., there is no memory space 
selector byte stored in memory). 

The display format for a NULL pointer value is "(null)". The rules for detecting a NULL pointer value 
depend on the compiler you are using. See page 3-29 for specific details about NULL pointer values. 



mMihh 



(myJih 



(m)-Jihhh 
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Structures, Unions and Arrays 



The single-line "value" displayed for a structure, union or array object is the data type name itself 
("struct...", "union..." or "[n]..."). 

In the main-screen Watch Window and the pop-up Browse Windows, structures, unions and arrays are 
fully-expanded to show the individual members or elements. In these contexts, the individual members 
in a struct/union and the individual elements in an array immediately follow the single-line header for 
the structure, union or array. Each of these lines show the address, data type and value of the struct/union 



member or array element. 

Functions 



The value displayed for an entity of type "function returning..." is the name of the function itself. This may 
seem redundant and silly in the simple case, but if you are following (indirecting through) a pointer to a 
function, the software displays the name of the function pointed to by the pointer. 
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Configure | Options 



Expressions Command 



Configure \ Options \Expressions command displays a pull-down menu of commands to allow you to 
rol expression input (symbols and numbers), numeric value formatting, data structure formatting and 



The 

control expri 
data structure 



; features. 



Jonf iauri 



Emulator 

Mapp ing- 

Code Memory 
Xdata 
Mode 



File Run Display/Alter Misc Source/Symbols 

-Registers- 



Attri 
Uindo 



I dent 



Funct 

Save 

Resto 



Diagn 
Bad k 
Host- 



► ||:B2 R4:88 R5:B8 R6:B8 R7'B5 CV:8 AC 
||5 CCAP8H 88 CCAPBL - 88 CCAP1H 88 CCAP1L 88 

88 CCAPM8 88 



Translate Inpu 



Radix 

Unknown data type 




Break/ Trace He 1 p 

83C51FX CPE)- 

1 FB:8 0U:8 U:8 P:8 
CCAP2H 88 
CCAPM1 88 

SP : 27— 

3 08 88 88 88 88 88 ID Bl 
-File: thkf 51 1 . aom — 



Browse Windows Stack Off 

Struct/Union Indentation Short ► 

Member Names On 

Array Subscript Values On 



unknown/untyped 
short/'ushort 
intAiint 
long/ulong 
float 
double 



Hexadecimal 
Decimal 
Decimal 
Decimal 
Decimal 
Dec ima 1 



index** ) -t 



BrkCnt:8 Time: 2,229ps State : Break-point DPTR:81B3 PC:82B5 

RepCnt:l InactCnt:B Trace : Partial Read: 46x Trig: End BrkAddr:B2B5 



Case conversion to be applied to keyboard input and symbolic input from files 



Configure | Options | Expressions | Radix 



The Radix command allows you to specify the default radix (base) for numbers you enter that contain no 
explicit radix prefix or suffix. If you enter a number such as 10 or 101, it will be interpreted in the current 
default radix (base) as specified by this com- ^ 
mand. However, in certain contexts where it SSKiS^™SK^^^^^^^^^™BnHMU~ 

makes sense, the host software will temporar- 
ily override the current default. For example, 
when you enter a source line number as 



Unknown data 



type size 



#11 



Browse windows Stack 
Struct/Union Indentation 
Member Names 
Array Subscript Ualues 



00 00 00 00 




Sho 



Binary 

Octal 

Decimal 


( 2) 
C 8) 
(10) 


Hexddec ima 1 


(16) 





the software temporarily changes the default radix to 10 (decimal) before translating the '11'. In other 
cases, when the software displays a Dialog Box to obtain input, a prompt somewhere in the box (usually 
on the bottom border) indicates if the default radix has been changed temporarily. 

In any case, you can always provide an explicit radix designator in the constant to override any default 
interpretation. For example, '#0x23' designates source line number 35 decimal, as does '#35t'. 

In some cases, the software can automatically determine the appropriate radix based only on the 
characters and digits present in the constant. For example, 1A can only be the hexadecimal number OxlA, 
even though no explicit prefix or suffix is present. 
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Configure | Options | Expressions | Unknown data type size 



The Unknown data type size command tells the host software how many bytes to read, write or display for 
a value/symbol whose data type is "(unknown)" or "(untyped)". 



II Trans 1 ate I npu t 
Radix 


Upper ► 
16 ► 


|||UnknowTi data type size 





00 ccapmb - e 



e ee 00 08 06 

File: 




llBrouse Uindous Stack 
Struct/Tin i on I ndentat i on 




ShorlMl-4 decimal ) = 
On 



Configure | Options | Expressions | Browse Windows Stack 



The Browse Windows Stack command is a toggle command that controls how the system behaves when 
you are in a Browse Window (page 3-27) and press Ctrl-B to browse an object displayed in that window 
(e.g., following a pointer field in a linked list). 

The default behavior, corresponding to Browse Windows Stack set to Off, is for the software to "close" the 
current Browse Window before opening the next one. The net effect is that you can follow a pointer, but 
you cannot "backtrack" to the previous node (by pressing the Esc key). When you do press the Esc key to 
exit the Browse Window, you will be back at the place where you invoked the first Browse Window. 

A Browse Windows Stack setting of On causes successive pop-ups of a Browse Window to stack one on 
top of the other (recursively). You can backtrack to any of the previous Browse Windows by pressing the 
Esc key one or more times. As nice as it is, the reason that this is not the default system behavior is that 
you could cause the host software to overflow its own runtime stack by traversing too deeply into list or 
tree or whatever. 

However, even when you have Browse Windows Stack set to Off (default setting), there is a way to at least 
maintain a record of the nodes/objects you have visited while browsing. The "write the data in this window 
to a file" capability (Ctrl-W:Write File) is available in a Browse Window, regardless of the setting of the 
Browse Windows Stack toggle command. Thus, at each step along the way, you can write the entire 
contents of each Browse Window (node/object), successively appending to the same file. 

Note that all of the displays in this document were generated with Browse Windows Stack set to On. 
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Configure | Options | Expressions [ Struct/Union Indentation 



The Struct/Union Indentation command controls the indentation of structure and union members which 
are themselves structures, unions or arrays. The two indentation options available are 'Short' and 'Long". 
The default is 'Short' indentation. 

With 'Short' indentation, the members/elements of embedded structures, unions or arrays are indented 
two spaces from the beginning of the name of the "parent" member: 







=X:0164 






Addr 


Data Type 


Ualue 




II 




2 


0104 


struct Sr 


•t_Nd 


struct Srt_Nd 


* 


X 


0104 


union 




lf_link 


union 




X 


■0104 


->struct 


Srt N 


srx_lef t 


X:0124 




X 


0104 


->struct 


Srt_M 


srx fore 


X:0124 




X 


0107 


union 




rb link 


union 




X 


0107 


->struct 


Srt N 


srx_right X:0144 




X 


■0107 


->struct 


Srt_M 


srx_back 


XI0144 




X 


010A 


[41char 




srt ualue 


[41char 




X 


018A 


char 




[01 0x41 


'A J 65 




X 


:0106 


char 




[11 0x42 


'B' 66 




X 


018C 


char 




[21 0x43 


'C 67 




X 


018D 


char 




[31 0x00 


' ' 




$ 


010E 


uchar 




srt_wtype 


0x04 ' . ' 


4 1 




010F 


char 




srt_char 


0x4D J M' 


77 1 


X 


-0110 


int 




srt_int 


25 


: j 


X 


0112 


u int 




srt_f lags 


20 


: i 

: ! 
: : 


X 


0114 


long 




srt_long 


25 




X 


0118 


ulong 




srt_ulong 


25 




x 


011C 


float 




srt_f loat 


12345.678 


: : 
: i 



With 'Long' indentation, the members/elements of embedded structures, unions or arrays are indented 
two spaces from the beginning of the value field of the "parent" member: 



Addr 



X:8164 ->struct Srt_Nd neunode= 
Data Type Ualue 



0104 struct Srt Nd struct Srt Nd 



X.-0104 


union 






lf_ 


link 


union 




X:0104 


->struct 


Srt 


N 






srx_lef t 


XI0124 


X:0104 


->struct 


Srt. 


_n 






srx_f ore 


X:0124 


X:0107 


union 






rb_ 


link 


union 




X:0107 


— >struct 


Srt. 


H 






srx_right X:0144 


X:0107 


->struct 


Srt_M 






srx_back 


X:0144 


X:010A 


[41char 






srt 


_ualue 


C4 Ichar 




X:010A 


char 










[01 0x41 


J A' 65 


X:010B 


char 










[11 0x42 


' B' 66 


X:010C 


char 










[21 0x43 


'C 67 


X:010D 


char 










[31 0x00 





X:010E 


uchar 






srt 


_utype 


0x04 ' .' 


4 


X:010F 


char 






srt 


_char 


0x4D ' M' 


77 


X:0110 


int 






srt 


_int 


25 




X:0112 


uint 






srt 


_f lags 


20 




X:0114 


long 






srt 


-long 


25 




X:0118 


ulong 






srt 


ulong 


25 




X:011C 


float 






srt 


.float 


12345.678 





Note that this command has a visible effect only if the setting of the Configure \Qptions {Expressions [Mem- 
ber Names toggle command is 'On' (see page 3-18). 
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Configure | Options | Expressions | Member Names 



The Member Names toggle command controls whether or not the host software will display structure and 
union member names when displaying the individual members of a structure or union. The default is 'On'. 

This is an example of a union display generated with the Member Names toggle set to 'On' (the default): 

[j= D isplay/ft Iter Express icm= 



Express ion : 2J 



f lagsl_l 



Addr: X:08FF Size: l byte Type: union B_Flagsl 

X:BBFF union B_Flagsl b_f lagsl_l 
Addr Data Type Value 



K F 



Tine : 
InactCnt 



88FF union B_Flagsl union B_Flagsl 



X:88FF uchar 
X:88FF struct 



X:88FF 
X:88FF 
X:88FF 
X:88FF 



8 : l_uchar 
1 : l_uchar 
2 : l_uchar 
3:3 uchar 



full_ual 8x73 ' s' 
b struct 

bf_l 8x81 ' .' 

bf _2 8x81 ' . ' 

bf_3 8x88 ' .* 

bf 4 8x86 ' . ' 



115 

1 
1 
8 
6 



Here is what the same display looks like with the Member Names toggle set to 'Off: 



Express ion I 



=Display/'Alter Express ion= 



_t lagsl_l 



Addr: X:88FF Size: 1 byte Type: union B 

=X:88FF union B_Flagsl b_flagsl_l— = 
Addr Data Type Value 



K F 



Time: 
InactCnt 



:88FF union B_Flagsl union B_Flagsl 



X:88FF uchar 
X:88FF struct 
X:B8FF B:l_uchar 
X:B8FF l:l_uchar 
X:88FF 2 : l_uchar 
X:88FF 3:3 uchar 



8x73 J s' 115 

struct 

8x81 ' .' 1 
8x81 ' .' 1 
8xB8 ' . ' B 
8x86 ' . ' 6 
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Configure j Options | Expressions | Array Subscript Values 



The Array Subscript Values toggle command controls whether or not the host software will display an array 
element's subscript value (enclosed in square brackets) before the actual value of the array element itself. 
The default is 'On'. 

This is an example of an array display generated with the Array Subscript Values toggle set to 'On' (the 
default): 



X : 08FF [5 lint scores 
Addr Data Type Ualue 



tX:00FF 


[5 lint 


£5] int 


X:00FF 


int 


[0] 


x 10101 


int 


[11 1 


X:0103 


int 


[21 4 


X:B105 


int 


[31 9 


X : 81 07 


int 


[41 16 



Here is what the same display looks like with the Array Subscript Values toggle set to 'Off: 



:88FF 15] int scores= 



Data Type 



Ualue 





[51 int 


ESlint 


X:B8FF 


int 





X:8181 


int 


1 


X:8103 


int 


4 


X:8185 


int 


9 


X:0107 


int 


16 
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Configure 
Configure 
Configure 
Configure 
Configure 
Configure 



Options 
Options 
Options 
Options 
Options 
Options 



Expressions 
Expressions 
Expressions 
Expressions 
Expressions 
Expressions 



unknown/untyped 
short/ushort 
int/umt 
Joncj/ulong 

double 



These commands control the display format to be used for values of the fundamental (basic) data types. 



^onf i gure 



Emulator 

-Happ ing- 




File Run Di splay /A Iter Misc Source/Symbols 

■Registers- 



Break/ Trace Help 
83C51FX CPE>- 



► 11=82 R4=88 R5:88 R6:88 R7:B5 CV:B AC:i FB:8 W:8 U:8 P:8 
CCAP8H 88 CCAP8L 88 CCAP1H 88 CCAP1L 88 CCAP2H - 88 

88 CCAPM8 - 88 CCAPM1 88 

SP : 27— 



Trans 1 ate Input 


Upper ► 


Radix 


16 


► 


Unknown data type size 


1 




Browse Windows Stack 


Off 




Struct/Union Indentation 


Short 


► 


Member Names 


On 




Array Subscript Ma lues 


On 




unknown/untyped 


Hexadec ima 1 


► 


short/ushort 


Decimal 


► 


Hint/uint 


Decimal 





long/ulong 

float 

double 



88 88 88 88 88 88 ID 81 

-File: tbkf 51 1 . aom— 



index ++ ) -C 



BrkCnt :8 
RepCnt : 1 



Time : 
InactCnt : 



2j229jjs 



Character 
Hexadecimal 

oint DPTR:8183 PC:82B5 
Trace: Partial Read: 4bY. Trig: End BrkAddr:82B5 



Display in decimal format 



The available choices are: 



Command 


Controls Display 
Formatting 
for These Data Types 


Display Formatting 
Options Available 


Configure | Options \ Expressions {unknown/untyped 


(unknown) & (untyped) 


Character, 

Decimal 
(signed or unsigned), 

or 

Hexadecimal 


Configure \ Options \Expressions \ short/ushort 


short & unsigned short 


Configure \ Options \ Expressions \ int/uint 


int & unsigned int 


Configure \ Options \ Expressions \long/ulong 


long & unsigned long 


Configure \ Options \Expressions \ float 


float 


Configure \ Options {Expressions \ double 


double 



Note that there is no control needed for the char and unsigned char types, since values of these 1-byte 
types are always displayed in all three possible formats: hexadecimal, character and signed/unsigned 
decimal (in that order). 

If you select Decimal format, signed or unsigned decimal notation will be used depending on the actual 
data type of the value (e.g., signed decimal for int, unsigned decimal for unsigned int). 
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Configure | Options | Expressions Command Combinations 



The Configure | Options \Expressions commands operate, for the most part, independently of one another. 

For example, the following structure display was generated with everything set to the "maximum" 
{Struct/Union Indentation = Long, Member Names = On, Array Subscript Values = On): 



Addr 



X :B164 ->struct Srt_Nd neunode= 
Data Type Ualue 



:8104 struct Srt Nd struct Srt Nd 



X:8184 


union 






lf_link 


union 




X:81B4 


->struct 


Srt 


N 




srx_lef t 


X:0124 


X:8104 


->struct 


Srt. 


_N 




srx_f ore 


X:0124 


X:8107 


union 






rb_link 


union 




XI0107 


- >struct 


Srt 


N 




srx_right X:0144 


X:0107 


->struct 


Srt. 


_N 




srx back 


X:0144 


X:810A 


[4]char 






srt_value 


[41char 




X:818A 


char 








[0] 0x41 


'A' 65 


X:010B 


char 








[1] 0x42 


'B' 66 


X:010C 


char 








[21 0x43 


J C 67 


X:010D 


char 








[3] 0X00 





X:010E 


uchar 






srt_wtype 


0x04 ' .' 


4 


X:010F 


char 






srt_char 


0x4D ' M' 


77 


X:0110 


int 






srt_int 


25 




X:0ii2 


uint 






srt_f lags 


20 




X:0114 


long 






srt_long 


25 




X:0118 


ulong 






srt_ulong 


25 




x :011c 


float 






srt_f loat 


12345.678 





Here is the same structure display generated with everything set to the "minimum" 
(Struct/Union Indentation = Short, Member Names = Off, Array Subscript Values = Off): 



=X:0164 ->struct SrtJId neunode= 
Addr Data Type Ualue 



a 


:8184 


struct Srt_Md 


struct Srt Nd 


X 


:8184 


union 




un ion 


X 


:8184 


— >struct 


Srt_N 


X:0124 


X 


:8184 


— >struct 




X:0124 


X 


:B187 


union 




union 


X 


:B187 


— >struct 


Srt N 


X:0144 


X 


:B187 


->struct 


Srt_N 


X:0144 


X 


:818A 


[41char 




[4] char 


X 


:818A 


char 




8x41 'A' 65 


X 


:818B 


char 




8x42 ' B J 66 


X 


:818C 


char 




8x43 *C 67 


X 


:B18D 


char 




8x88 ' . ' 


X 


:818E 


uchar 




0x84 ' . ' 4 


X 


:818F 


char 




0x4D * M' 77 


X 


:B118 


int 




25 


X 


:B112 


uint 




20 


X 


:0114 


long 




25 


X 


:0118 


ulong 




25 


X 


:011C 


float 




12345.678 
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Watch Window 







Commands The Configure \ Windows | Watch pull-down menu contains five commands to allow you to define and 
manipulate the content of the Watch Window. 



^onf igure 



File Run 



The Add command lets you add any non-constant expression to the Watch 
Window. Note that the host software reevaluates the address designated by 
the watch expression each time the Watch Window is updated. Thus, if you 
add the expression my_array[i] to the Watch Window, the host software 
recomputes the subscript value of / each time the software updates or 
repaints the Watch Window. 

The Delete command deletes (removes) a single, designated expression 
from the Watch Window. 

The Clear command deletes (removes) all watch expressions from the 
Watch Window. 

The Save command saves (writes) all the watch expressions in the Watch 
Window to a file of your choice. You can later load (add) these saved watch 
expressions to the Watch Window by selecting the Configure {Win- 
dows | Watch \Load command below. 



Emulator 

ppi ng- 
Code Memory 
Xdata Memory 
Mode 

— Display- 
Attr ibutes 
TTf 



ai y 



Mod try Ctrl-F6 ► 
Size Ctrl-F7 
Goto Ctrl-F8 
Repaint Alt-Fi 



dd Ctrl-F9 ► 



Delete Ctrl-F18 ► 
Clear 

Save ► 
Load ► 



The Load command loads (restores) into the Watch Window the watch expressions saved in a file by the 
Configure \ Windows \ Watch \Save command above. 

The various commands, or the entire menu, may be inactive (inaccessible) depending on the current state 
of the system. For example, if the Watch Window is empty, the Delete, Clear and Save commands will be 
inactive (inaccessible). 

Display The Watch Window has four columns, showing the address of the watch expression, the data type of the 

Format watch expression, the watch expression itself and the current value of the watch expression: 



Configure File iTHHI Display/Alter Misc Source/Symbols Break/Trace Help 
Module :Tft Source — — Fi le :takf 51 1 .aom- 

77 arytail = aj; 

Uatch 

X:B88E uint ai % 

Sttiiaia uchar arytai] 2S^B^Cfi 

X:B884 [10] uchar ary [10]uchar 

X:8084 uchar [81 0x24 '$' 36 

X:8885 uchar t 11 8x26 38 

X:0086 uchar [21 0x28 ' (' 40 

X:8087 uchar t 31 0x2A 42 

X:8088 uchar [41 0x2C ' 44 

X:0089 uchar 15] 8x2E ' .' 46 

X:B88A uchar t 61 8x2F 47 

X:888B uchar [71 8x31 '1' 49 

X:888C uchar t 81 0x33 '3' 51 

X:008D uchar -- £9] 0x35 '5' 53 

X;00A8 ->struct List p_list (null) 

C:0000?struct List *p_list struct List 

C:8080?uint list_uiual 517 

C: 80027- >struct List 1 ist_p_nxt ? :FFFF<CEFFFF> 

X:0880 Float iteration 38.5 



Begin emulation 
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If the watch expression is a structure, union or array type, then there will also be a line for each constituent 
component in the watch expression: each member in a struct/union or each element in an array. In this 
case, the watch expression field contains " ". 

Every time the host software updates or repaints the Watch Window, it highlights the value field of each 
watch expression or constituent component if the current value is different from the previous value. This 
highlighting is done to notify you of the change in value. Similarly, if the address associated with the watch 
expression or constituent component changes, the software highlights the address field. (The address 
associated with a watch expression can change if you are watching an expression such as my_array[i], 
where the actual array element being monitored changes as the value of / changes.) 

If the host software encounters an "illegal" value in evaluating the address of a watch expression, it flags 
the watched object with a question mark (?) between the address column and the data type column. This 
can happen if the watch expression involves indirection through a pointer and the value of that pointer is 
NULL or illegal (see page 3-13). 

Browsing You can enter Change Mode to browse the Watch Window by pressing the Tab key (which is simply a 
convenient shortcut for the Configure \Windows\Goto command) one or more times until the Watch 
Window title is highlighted: 



i Modu le : Tfl- 

90 



-Source- 



I! 

File:taM511 .ao*— 



91 
92 
93 
94 
95 
96 
97 
98 
99 

180 End_Loop 
181 

182 > /* 

183 



/« scan through nodes in 1 ist 
p_list = list_head; 
while (p_list •= NULL) < 

lj = p_I ist->list_uiual; 
p_list = p_l ist->l ist_p_nxt; 
> /-while p_list»/ 



iteration 
■a in 



= 1.15 
X:B89E 



Addr Data Type 



->struct List- 
Ualue 



X:B897 struct List 



:B897 uint 



X:8899 ->struct List 
184 > /"main*/ 1=Enter : Change 



struct List 



list uiual 142 



list_p_nxt X:8092 



— Enter : Change- 
X:B8A8 ->struct List 
X:B89C struct List 
X.889C uint 



P_l ist 
«p_l ist 



leted) */ 



-Ctr 1 -B : Browse— 



X : 889C 
struct List 
list uiual 



146 



1 X:809E ->struct List 




list_p_nxt X:BB97 


X:B88B float 


iteration 


158.7 



Tah/Shift-TahlNext/Preu window (Keypad ): Scro 1 1 Esc : : Ex i t 



As you scroll up or down in the Watch Window, the software will display prompts on the top border of 
the Watch Window indicating what actions you can perform on the highlighted item: 

EntenChange - (upper-left border) The currently highlighted item is a fundamental value or a 
pointer, either of which you can change. Pressing the Enter key pops up a Change Box (see page 
3-26), allowing you to change the item's current value. 

Ctrl-B:Browse - (upper-right border) The currently highlighted item is a pointer which can be 
"followed". Pressing the Ctrl-B key sequence pops up a Browse Window (see page 3-27), allowing 
you to browse/inspect the object pointed to by the pointer value. 
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Source/Symbols 



The following Source/Symbols windows display the internal symbol table sorted in various ways: 

Source/Symbols \ Global: global (PUBLIC) symbols, sorted alphabetically 

Source/Symbols [Local: local symbols, sorted alphabetically within each scope 

Source/Symbols \Alpha: global and local symbols, sorted alphabetically 

Source/Symbols \Address: global and local symbols, sorted by address 

All these windows have the same basic display format. Following is a display generated by the 
Source/Symbols \ Local command: 



Configure File Bun Display/Alter Misc 

iu le : TB Source- 



SB Break/Trace Help 
File:thkf511 



Enter Symbol 



-Local Symbols - By Module- 



(104 Symbols) 



Symbo 1 Name 



Defined With in 



Addr 


(H : Module F: Function) Data Type 


ila lue 


C U ■ Scope Leuel) 


C:B4DD 




arrays 


Ovoid 


arrays 


1 


TB ♦ 




F 


MAIN 










X:88A1 




ages 


[201int 


[28Hnt 


2 


HA IN 


X:88CS 




average 


int 


-1233 


2 


HA IN 


X:88ED 




dsp_f tn 


->()f loat 


C:833A 


2 


HA IN 


X:80CF 




per_l 


struct per 


struct per 


2 


MAIM 1 


||X:00EA 




per_pl 


— >struct per 


X:80CF 


2 


HA IN ■ 


X :00F8 




sptr 


->struct Srt_N 


(null) 


2 


HA IN 


X80F3 




textbook 


struct book 


struct book 


2 


MAIN 


X:889D 




X 


int 


5 


2 


MAIN 


X:B89F 




y 


int 


IB 


2 


HA IN 


X:88CB 




z 


float 


12345.678 


2 


HA IN 




F 


DO_NO THING 










B:80Z8 




key 


bit 


1 


2 


DO_NO THING 


"=Enter 


: Change 


= Ctrl-R:Resize Ctrl-V- 


Moue 




<tr 1-B : Browse 11 



l_ 



Source leuel debug and symbol displays 



The information presented for each symbol consists of memory address, symbol name, data type, current 
value and the scope in which the symbol was defined. Each symbol occupies one line in these displays. If 
the symbol is a structure, union or array, its constituent components (struct/union members or array 
elements) are not shown in these displays. To see the individual struct/union members or array elements, 
you must press the "browse" key combination (Ctrl-B: Browse - see below). 

As you scroll up or down in these Source/Symbols windows, the software will display prompts on the 
bottom border of the window indicating what actions you can perform on the highlighted symbol: 

EntenChange - (bottom-left border) The currently highlighted symbol's data type is one of the 
fundamental types or it is a pointer. Pressing the Enter key pops up a Change Box (see page 3-26), 
allowing you to change the symbol's current value. 

Ctrl-B: Browse - (bottom-right border) The currently highlighted symbol is an array, structure or 
union, or it is a pointer (which can be "followed"). Pressing the Ctrl-B key sequence pops up a Browse 
Window (see page 3-27), allowing you to browse/inspect the array elements, struct/union members 
or the object pointed to by the pointer variable. 
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Display/ Alter | Expression 



The Display/Alter {Expression command pops up a dialog box allowing you to view or change the value 
stored in a location designated by an arbitrary expression. 



i splay /A Iter 



Configure File Run ll, 
iule:m 

84 node ||ftst«/Das« 

85 node 
86 
87 



Expression: ai 




Hisc Source/Symbols Break/ Trace Help 
File:takf511 .ao«- 



Shift-F4 ► 
enory 



Code 


Alt-F2 






Hi data 


Alt-F3 




); 


HXdata 


Alt-F4 




nes 






sion Alt-F5 


E 



* 4) ♦ ma in_loop_f actor; 

: B) ? NULL : «(nodes[li-ll) 



nes inserted/deleted) 



-Display/Alter Express ic 



Addr: X:B88E Size: 2 bytes Type: uint 
Content 



Esc: Do not change current ualue 



(for demo's — in case lines inserted/deleted) */ 



while TRUE*/ 



183 

184 > /«main»/ 



Uieu/change the value in any uariable, register, bit, 



location, etc. 



The dialog box shows the address, size (in bytes or bits) and data type of the expression you enter. If the 
expression designates a location whose content can be changed, the "Current." field shows the value 
currently stored in that location. 

If the expression you enter designates a structure, union or array value, the software shows the address, 
size and data type of the expression. Additionally, the Ctrl-B:Browse prompt appears on the bottom-right 
border of the box to indicate that you can pop up a Browse Window (page 3-27) to inspect and/or change 
the individual members in the struct/union or the individual elements in the array: 

=Display/Alter Expression 

Express ion : 

Addr: X:0084 Size: 10 bytes Type: [101uchar 



' "<expr>" or "<expr> <neu value>" Ctr 1-B : Brouse 

If the expression you enter designates a "pointer to..." value, you have the option of either changing the 
pointer, by entering a new value, or "following" the pointer, by pressing Ctrl-B (Browse). 

Note: Currently, the expression entered in the "New:" field is evaluated for address, not for value. For 
example, if you enter /', the address of the variable /' is used as the new value, not the content of the variable 
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Change Box 



A Change Box is very much like the Display/Alter\Expression command's pop-up dialog box. The 
difference is that, with a Change Box, the expression or variable whose value is to be changed is already 
known. 



Configure File Run Display/Alter Misc 
l — Hodu le : TA Source- 



Break/" Trace He 1 p 
— File:takf511 .aom- 



Enter Symbol 



lis - By Module- 



CIS Symbols) 



Symbol Name 
Addr (M:Module F : Function) 



Data Type 



Value 



Defined Within 
(It: Scope Level) 





|X :H08E 


a i 


u i nt 


ib ; 


: MAIN 


■ 



Change Ualue (Content) | 19 
Addr: X:888E Size: 2 bytes Type: uint ClBJuchar 

Content II 1 . 1 

Current: It} H 3 

PJHHPJJIHHHHI 

Esc: Do not change current ualue " 1 

80AB ma in_loop_f actor uint 2 



Neu: 



MAIN 
MAIN 
MAIN 
MAIN 
MAIN 
MAIN 
MAIN 



Ctrl-R:Resize Ctrl-U:Moue 
/* scan through nodes in 1 ist */ 



! =Enter : Change 
98 

91 P_list = 1 ist_head : 

92 while (p_list t= NULL) t 

93 1J = p_list->list_uiual 

94 P_list = P _list->list_p_nxt 

95 > /"while p_list»/ 



Source leuel debug and symbol displays 



A Change Box pops up when you press the Enter key in response to the EntenChange prompt in the 
following contexts: 

■ Watch Window (page 3-23) 

■ Source/Symbols windows (page 3-24) 

- Source/Symbols | Global command 

- Source/Symbols | Local command 

- Source/Symbols \Alpha command 

- Source/Symbols \Address command 

■ Browse Windows (page 3-28) 
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Browse Windows 



A Browse Window pops up to allow you to view (inspect) and/or change the 

■ members in a structure or union 

■ elements in an array 

■ object designated by a pointer value (i.e., to "follow" the pointer) 

Here is a Browse Window popped-up from the Display /Alter\Expression command to examine the 
individual elements in the array ary: 



Configure Filf 
ule:TA 



Run 



D i sp lay/Al ter 



Misc 
-Source- 



Source/Symbo 1 s 



Break/Trace Help 
— File:takf511 .aom- 



75 
76 
77 
78 
79 
88 
81 
82 

84 

85 
86 
87 
88 
89 
98 
91 
92 
93 
94 
95 



for 



C ai = 8; 
aj = (ai 
ary la i 



ai 

2) 



List 

Exp: 



In it: Cfor 



Addr: X:B884 Si 



< ARVSIZ; ai** ) < 
* it»ain_loop_f actor; 
— X:8884 ClBluchar ary 



M&r Data Type 



Value 



X:8884 ClBluchar 
X:8984 uchar 
X:8885 uchar 
X:88B6 uchar 
X:8887 uchar 
X:8888 uchar 



X!808A uchar 
X:888B uchar 
X:888C uchar 
X:888D uchar 
-Enter : Change" 
t= NULL) { 



[ 18 luchar 
[ 81 8x82 
C 11 8x84 
[ 21 8x86 
[ 31 8x88 
[ 41 BxBA 

n 



List_Scan: /* Cfor 
/* scan th 
p_list = 1 
while (p_list 

lj = P_list->list_uiual; 

p_l ist = p_l ist-> 1 ist_p_nxt ; 

} /"-while P _list»/' 



61 
71 
83 
91 




Display/Alter 



A Browse Window pops up when you press the Ctrl-B key in response to the Ctrl-B:Browse prompt in 
the following contexts: 

■ Watch Window (page 3-23) 

■ Source/Symbols windows (page 3-24) 

- Source/Symbols \ Global command 

- Source/Symbols \ Local command 

- Source/Symbols \Alpha command 

- Source/Symbols \Address command 

■ Display /Alter\Expression command (page 3-25) 

■ Browse Windows (e.g., to follow a pointer which is a struct/union member or an array element) 

Structures, unions and arrays are fully "expanded" in a Browse Window to show all constituent compo- 
nents: each member in a struct/union or each element in an array. This process applies iteratively if a 
component is itself a structure, union or array. 

The Configure \ Options \ Expressions \Browse Window Stack toggle command (page 3-16) controls how the 
system behaves when you are in a Browse Window and press Ctrl-B to browse an object displayed in that 
window (e.g., following a pointer field in a linked list). 
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The following keys are available in a Browse Window: 

EntenChange - (lower-left border) The currently highlighted item is a fundamental value or a 
pointer, either of which you can change. Pressing the Enter key pops up a Change Box (see page 
3-26), allowing you to change the item's current value. 

Ctrl-B:Browse - (lower-right border) The currently highlighted item is a pointer which can be 
"followed". Pressing the Ctrl-B key sequence pops up another Browse Window, allowing you to 
browse/inspect the object pointed to by the pointer value. 

Ctrl-W:Write - (upper-right border) Pressing Ctrl-W allows you to write the entire contents of the 
Browse Window to a file of your choice. The software will prompt you for the name of the file and 
ask you whether you want to append to that file (add to the end of the file) or overwrite it (start over 
at the beginning of the file). 

CtrI-R:Resize Ctrl-V:Move - (lower-middle border) This allows you to move the Browse Window 
anywhere on the screen or to change the size of the Browse Window to almost any size you want. 
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Compilers 



This section describes how to get the most out of the capabilities in the iceMASTER host software in 
combination with the particular compiler product you are using. iceMASTER currently provides full data 
type support (structures, unions, arrays, etc.) for the compilers listed in this section. More comprehensive 
support for other compilers will be added in the near future. 



Keil/Franklin C51 



This information applies to version V3.07 of C51 (C compiler) and version V2.7 of L51 (linker). It should 
be accurate for later versions of these products and may even be valid for earlier versions. 



Recommended Compilation Options 



DEBUG Include debug information in the object file. 

OBJECTEXTEND Include full data type definition debug information in the object file. 

NOREGPARMS Do not pass function parameters in registers. 

OPTIMIZER) Do not put auto variables in registers. 



Recommended Linking Options 

DEBUGLINES Include source line number debug information in the output file. 

DEBUGPUBLICS Include public (global) symbol information in the output file. 
DEBUGSYMBOLS Include all symbol information in the output file. 

Pointers 



The Keil/Franklin C51 compiler implements both generic pointers and memory-specific pointers (see 
page 3-13). 

NULL 

The value of a NULL generic pointer is a pointer value with all three bytes containing zero (even the 
selector byte). This is true regardless of whether the pointer is being read (e.g., for comparison to NULL) 
or written (i.e., NULL being assigned to the pointer). 
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'typedef Names 



The iceMASTER host software is internally set up to display typedef names, where appropriate. However, 
the compiler does not output any information about typedefs. The compiler always outputs the underlying 
type. For example, in 

typedef struct abc (...) ABC ; 
ABC xyz ; 

There is no information about 'ABC in the AOM file (Absolute Object Module file, load module file). 
The data type of 'xyz' is recorded as 'struct abc', not 'typedef ABC. Likewise, for 

typedef unsigned char logical; 
logical bool_val; 

there is no information about 'logical' and the type of 'bool_val' is recorded as unsigned char. 

Enumeration Types 

The iceMASTER host software is internally set up to display enumeration values as they were declared 
in the C source program (e.g., 'RED', 'GREEN', 'YELLOW, rather than 0, 1, 2). However, the compiler 
does not output enumeration type information. The AOMF-specified type of enum variables always 
seems to be signed int. 

'double' Types 



The data type double (double-precision floating-point) is implemented by the compiler as float (single- 
precision floating-point). The data type information in the AOM file for variables declared as 'double' 
reflects this. 

Batch "Make" Files 



The batch "make" files TAKF51.BAT and TBKF51.BAT show how the example programs TA.C and TB.C 
were compiled and linked. 
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lAR/Archimedes C-51 



This information applies to version V4.23E/DXT of C-51 (C compiler) and version V4.44D/DXT of 
XLINK (linker). It should be accurate for later versions of these products and may even be valid for 
earlier versions. 

Recommended Compilation Options 



-rOn Put only symbolic information (no source code) into the object file. 

Do not add extra NOPs at source line boundaries. 

Do not specify '-rl...' or '-r2...': The iceMASTER emulators break emulation before the instruction at a 
break-point is executed. Thus, no extra NOPs are needed in the generated code. 

Warning: Do not specify '-rOi...' (add #include file source code to object file) and do not forg et to specify 
the 'n ! in '-rOn'. The host software ignores the source images embedded in the load module file. 
iceMASTER locates your original source file on disk and reads that file when displaying source images. 
Additionally, the line numbers recorded in the resultant load module file (for '-rOi...') will not match the 
original source file found on your disk. 

Recommended Linking Options 



-Fdebug Create the load module file in the IAR/Archimedes DEBUG format (.DBG). 



Pointers 



The IAR/Archimedes C-51 compiler implements only generic pointers; there are no memory-specific 
pointers (see page 3-13). 

NULL 

The value of a NULL generic pointer is dependent on the context. 

Reading In comparing a pointer value to NULL, only the offset portion (hhhh) is examined (for both bytes being 

zero). The value in the memory space selector byte is ignored. 

Writing When NULL (zero) is assigned to a pointer, all three bytes in the pointer (including the memory space 

selector byte) are set to zero. 
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'typedef Names 



The iceMASTER host software is internally set up to display typedef names, where appropriate. However, 

type. For example, in 

typedef struct abc (...) ABC; 
ABC xyz ; 

There is no information about 'ABC in the .DBG file (load module file). The data type of 'xyz' is recorded 
as 'struct abc', not 'typedef ABC. Likewise, for 

typedef unsigned cbar logical; 
logical bool_val; 



there is no information about 'logical' and the type of 'bool val' is recorded as unsigned char. 



Enumeration Types 



The iceMASTER host software is internally set up to display enumeration values as they were declared 
in the C source program (e.g., 'RED', 'GREEN', 'YELLOW, rather than 0, 1, 2). However, the compiler 
does not output enumeration type information. The .DBG-specified type of enum variables always seems 
to be signed int. 



'double' Types 



The data type double (double-precision floating-point) is implemented by the compiler as float (single- 
precision floating-point). The data type information in the .DBG file for variables declared as 'double' 
reflects this. 



Batch "Make" Files 



The batch "make" files TAIA51.BAT and TBIA51.BAT show how the example programs TA.C and TB.C 
were compiled and linked. 
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Appendix A: Source Window & Assembler/Disassembler 



Source Window 



The Source Window is used to display the source program and/or disassembled instructions in Code 
Memory. The current module (see the Source/Symbols \ Current Module command) is displayed on the 
left side of the top border and the filename of the currently loaded program (see the File \Load command) 
is displayed on the right side of the top border. 

The information in this window may be displayed in 'Code', 'Mixed' or 'HLL mode. 'Code' means just an 
assembly language disassembly of the code will be displayed. 'Mixed' means that HLL source lines (e.g., 
C language), if available, will be displayed along with the disassembled code. 'HLL means that just the 
HLL source lines will be displayed. The default is 'HLL but can be changed under the Options column 
of the Configure \ Windows \Modify command. 

The starting address of the code displayed is at the PC address and cannot be changed. Note that during 
single step (Run \Step) or slow motion operation (Run \Slow Motion) the starting address of the screen 
does not change until the flow of execution moves out of the code that appears in the window, at which 
time a new window full of code will be displayed. This is intended to keep the Dynamically Annotated 
Code visible as long as possible. 

In Change Mode, the Source Window also allows you to control the emulation environment. 

You can enter Change Mode to browse/peruse the Source Window by pressing the Tab key (which 
is simply a convenient shortcut for the Configure \ Windows \ Goto command) one or more times until 
the Source Window title is highlighted. 

Once you are in Change Mode, by pressing *- , -» or Enter, the Source Window Control Menu becomes 
available. 

■ Sou rce U irtdou Control 

Brouse Change_Module iBTira Lahel_Synch Set_Break Assemble 
1 Mode=HLL Labe 1-Synch=0ri 

Source Window Control 



The Source Window Control Menu is a menu bar window which allows you to browse through or change 
your code, change the display mode, turn disassembly label synchronization ON and OFF, set or clear 
simple break-points and set temporary break-points. The commands are: 

Browse 



The Browse command allows you to quickly reposition the highlight bar in the Source Window. If the 
Source Window display mode is Code or Mixed, you will be prompted for an address to go to. If the Source 
Window display mode is HLL (source only), you will be prompted for a line number. However, you may 
enter any address expression (numerically or symbolically) or line number at either prompt. Note that if 
the display mode is HLL and you want to switch to a different module, use the Change Module command. 
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Change Module 



In HLL (source-only) ox Mixed display mode, you can use the Change Module command to display (switch 
to) a different module in the Source Window. 

Mode 



The Mode command calls a Pull-down Menu from which you may set the display mode for the Source 
Window. The available choices are Code, Mixed and HLL (source only). 

Mode | Code 

The Code command changes the display mode of the Source Window to a disassembled view of code 
memory. 

Mode | Mixed 

The Mixed command changes the display mode of the Source Window to a disassembled view of code 
memory, interspersed with HLL source line images for code-generating source lines. 

Mode | HLL 

The HLL command changes the display mode of the Source Window to a source-only view of the 
HLL source module corresponding to the currently highlighted line. This display mode shows both 
code-generating and non-code-generating source lines. 

Label-Synch 



The Label-Synch command is used to toggle disassembly label synchronization ON and OFF in the 'Code' 
and 'Mixed' display modes. When Label-Synch is ON, the Host Software uses existing code labels to verify 
that disassembly addresses are on instruction boundaries. If they are not, addresses will be adjusted so 
that the disassembly does begin on an instruction boundary. If Label-Synch is OFF, no such checks are 
made and the disassembly will start at the specified address. 

Set Break 



The Set Break command calls a Pull-down Menu from which you may set or clear simple break-points 
and set a temporary break-point. 

Set Break \ Toggle 

The Toggle command toggles (on or off) a permanent simple break-point at the currently highlighted 
line. Permanent simple break-point locations are flagged with the> character and may be modified 
in the Break/Trace\Set menu. 

Note that Ctrl-B (toggle .break-point) performs the same function as the Set Break \ Toggle command. 
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Set Break] Run Until 



The Run Until command sets a temporary break-point at the currently highlighted line and then 
begins emulation immediately from the current PC. This command is essentially the same as the 
primary Run \ Until command, except that the temporary break-point address is implicitly denoted as 
the currently highlighted line in the Source Window. 

Note that this "set temporary break-point and start emulation" function may also be accomplished 
directly from the source window by pressing Ctrl-T (set .temporary break-point and go). 



Assemble 



The Assemble command invokes the Assembler/Disassembler menu (Display </Alter\Asm/Dasm com- 
mand) to allow you to browse through or change (patch) code. 



Display/Alter | Asm/Dasm 



The Display/Alter | Asm/Dasm command calls Assembler/Disassembler Menu Bar Window from which 
you may assemble instructions into code memory and browse through the disassembled code memory. 
Browse mode is active on entrance to the Asm/Dasm Menu. 



Configure File Run 



1 splay/A 1 ter 



B rouse Assemb le 

— flodu I e : F_HLHA 1 N 

Addr Code Label 



Misc Source/Symbols Break/ Trace 
"■""-'fl s semh 1 er /D i sassemb 1 er 
■ rTTira Label -synch write 



Help 



-File:f_demo.ac 



Instruction 



B8AC 12BBEC LCALL UASTETIME 

F_HLMAIN:S39 UasteTineO; 

00AF 12BBEC LCALL UASTETIME 

F_HLMAIN:*48 > /* end of: for 'counter' 

B8B2 B52B INC COUNTER 

B0B4 88EF SJMP B8A5h 

F_HLHAIN:»42 > /"* end of function: 'nainO' */ 

B8B6 22 RET 

F_INNER:ttl4 Kuoid InnerLoopC char repeat cnt ) 



BB7K8F24 _INNERLOOP: MOU REPEAT CNT.R7 



;f_hlmain: 

/*• blank pulse between sets of 5 pill 
:F HLMAIN:*39| 



F_INNER:ttlB 
B8B9 E4 
00 B A F522 
B0BC C3 
B8BD E524 
•*=Mode=M ixed= 



t_cnt: i+* ) { 



for ( i = 8; i < 
CLR A 
MOU I j A 
CLR C 

MOU A,REPEAT_CNT 
= — Ctrl-R: Resize Ctrl-U:Moue 



;F HLMAIM:«40;ii 



;F HLMAIN :tt42;l 



:F INNER :«14 



;f_imner:»ib| 



iii 



=Label-Synch=0 




T oggle d i splay m o de betw een Code ( instrs only) a n d Mixed ( instrs ♦ HLL i m ages) 

si *39 2^S2S disassw 2S35S ^^2E3ii 



Note that the right side of the top border line (under the Menu Bar) shows the filename of any loaded 
code file, the left side of the bottom border line shows the Display Mode, the center of the bottom border 
line shows current key information and the right side of the bottom border line shows the Label-synch 
mode. The commands are: 



Display/Alter | Asm/Dasm | Browse 



The Browse command calls a dialog box from which you may enter an address expression. If an address 
is entered the display will be repainted starting at the specified address. 
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Note that if an absolute address is entered and the Label-synch Mode is OFF, the address may or may 
not correspond to an instruction boundary and may result in an 'out-of-synch' disassembly. 

Note for iceMASTER-68HCll and iceMASTER-68HC05 disassemblies: Several opcode mnemonics 
have aliases (alternative mnemonic names). In such cases, the alternative name will be shown as a 
comment next to the disassembled instruction: 



68H 


CU 


68HC05 




. Alias 


Mnemonic 


Alias 


ASL 


LSL 


BCC 


BHS 


AS LA 


LSLA 


BCS 


BLO 


ASLB 


LSLB 


DECX 


DEX 


ASLD 


LSLD 


INCX 


INX 


BCC 


BHS 


LSL 


ASL 


BCS 


BLO 


LSLA 


AS LA 






LSLX 


ASLX 



You can use either form shown above when patching in new instructions using the single-line assembler 
(Display /Alter\Asm/Dasm \Assemble command). 

In addition, for the iceMASTER-68HCll and iceMASTER-68HC05, disassembled code memory at the 
current Interrupt Vector area will be displayed as follows: 

ivect < address > 

The current 68HC11 Interrupt Vector area is determined by the current operating mode of the processor 
in the probe card. The Special Modes Interrupt Vectors are located at SBFCO through $BFFF. The 
Normal Modes Interrupt Vectors are located at $FFC0 through $FFFF 

The location of the 68HC05 Interrupt Vector area is dependent on the particular chip derivative: 
$1FF0-$1FFF, $1FF4-$1FFF, $1FF8-$1FFF or $3FF0-$3FFF. 

Note that interrupt vectors may be set through the Assemble command (described below) using 

DB $hhhh 

where $hhhh is the address to put in the vector. 
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Display/Alter | Asm/Dasm | Assemble 



The Assemble command turns on Assemble Mode. In this mode you may enter new instructions (and 
labels) into code memory a single line at a time, at the current (highlighted) address. The address at which 
to add the instruction may be changed by using Browse mode (described above) or by using the I or t 
keys to increment or decrement the address. 



Configure File Run 



1 splay/A Iter 



II Browse 
H— Module :F_H 
Addr Code 



ssenb le 



disc Source/Symbo I s Break/ Trace Help 
-Assemh ler/T) i sassemb 1 er ^ ~ 
Mode Label-synch Urite 




88 AC 1288EC LCALL UASTET IME ;F_HLMAIN :«38j} 

F_HLHAIN:*39 UasteTimeO: /» blank pulse between sets of 5 p 

B8AF 1280EC LCALL UASTET IME ;F_HLMAIN :«39 

F_HLMAIN:»48 > /* end of: for 'counter' •/ 

B8B2 8528 INC COUNTER ;F_HLMAIN :»4B 

88B4 88EF SJMP B8A5h 

F_HU1AIN:*42 > /* end of function: 'nainO' 

08B6 22 RET l F_HLMA IN : 842 

FINNER : 814 ►void InnerLoopC char repeat_cnt ) 



0B7^8F24 INNERLOOP: H00 REPEAT CNT.R? 



F_INNER:ttl8 
80B9 E4 
80 BA F522 
C3 
D E524 
e=Mixed= 



for ( i = 0; i < repeat_cnt: 
CLR A 
MOU I, A 
CLR C 

IKW A jREPEAT_CNT 
— — Ctrl-R:Resize Ctrl-U:Moue 



i** ) < 



;F INNER :ttl4 



;F INNER :»1B 



=Label-Synch=On= 



A ssemble instruc t ions in to code m emory) ( p atch code memory with n e u instructions) 



When entering an instruction, symbolic information maybe used. This includes the ability to define a new 
label at the current address and to use symbolic names in the operand part of the instruction. When a 
new label is entered, it is inserted into the internal symbol table as a global (public) symbol. 

Note that if the assembled instruction does not contain the same number of bytes as the original 
instruction at the current address you will be notified and asked to verify the operation through a 
Confirmation Box. Note that the, Assemble command is enabled only for a line of machine code, NOT Tor 
HLL source statements. 

To exit Assemble Mode press Esc to return to the Menu Bar. 

Di splay/Alter | Asm/Dasm | Mode 



The Mode command is used to toggle the display mode between 'Code' Mode and 'Mixed' Mode. The 
'Code' display Mode means that just assembly language instructions are displayed. The 'Mixed' display 
Mode (available only if HLL source is available) means that HLL source images are interspersed with 
the assembly code. 



Display/ Alter | Asm/Dasm | Label-synch 



The Label-synch command is used to toggle disassembly label synchronization ON and OFF. When 
Label-synch is ON, the Host Software uses existing code labels to verify that disassembly addresses are 
on instruction boundaries. If they are not the Host Software will adjust the address so the disassembly 
begins on an instruction boundary. If the Label-synch mode is OFF, no such checks are made and the 
I start at the specified address. 
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Note that if Label-synch Mode is OFF, the specified address may or may not correspond to an instruction 
boundary and may result in an 'out-of-synch' disassembly. 

Display/Alter | Asm/Dasm j Write 

The Write command is used to write the disassembled contents of code memory to a disk file. The format 
of the information written to that file will be just as you see it on the screen (i.e., in human-readable form), 
in the current display mode. 

The Write command opens a Dialog Box with the Program Memory span information given to you as well 
as the From and To address you wish to write. After entering the address/label information, you will be 
prompted for the filename by a Filename Dialog Box. If this filename already exists, you will be requested 
to Append or Overwrite the file. Press Y to Append to the file or N to overwrite the file. 
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Appendix B: Virtual Memory Support 





Command Line Options 



-vme < pages_per_allocation_request > 
-vmf <num_bufs> <buf_size> 
-vmfn <file_name> 

These options control how virtual heap memory will be used. Enabling virtual heap memory allows 
the Host Software to use memory located outside the conventional 0-640Kb memory area normally 
usable by a DOS program. This capability is useful if you have a program with a large number of 
symbols which cannot all fit into the symbol table in conventional memory. 

By default, the virtual heap memory is disabled and the Host Software builds the symbol table in 
conventional memory when loading a program file. If you ever see the following message at the top 
of the screen 



"Not enough unused memory available to continue ... press any key." 

the Host Software has used up all the conventional memory and, generally, cannot continue. If this 
happens, you should reinvoke the Host Software, specifying one or more of the command line 
options (-vme, -vmf and -vmfn) to enable virtual heap memory usage. However, note that loading 
files (building the internal symbol table) and some other commands within the Host Software (e.g., 
listing all symbols alphabetically) may be much slower when virtual heap memory is enabled. 

There are two basic kinds of backing store media (real memory/storage) used to support the virtual 
heap memory: 

1) LIM EMS 3.2/4.0 Expanded Memory, and 

2) a file 

The fastest medium is expanded memory and you should use this form if: 

1) You have an expanded memory card in your computer (any type of PC). To allow access 
to this expanded memory, you must have the appropriate 'DEVICE =..' statement in 
your CONFIG.SYS file; see the documentation accompanying your expanded memory 
board for the details on how to do this, or 

2) You have a '386 or '486 PC with no expanded memory, but with additional memory 
(extended memory) above the 1Mb boundary. In such a case, you can use the 
EMM386.EXE device driver supplied with DOS to simulate expanded memory in 
extended memory. A typical CONFIG.SYS file for this configuration would contain the 
following lines: 

DEVICE = C:\DOS\HIMEM.SYS 
DEVICE = C: \DOS\EMM386.EXE 

You can add additional parameters to the DEVICE command for EMM386.EXE to 
control the amount of expanded memory to be created (simulated) in your system. 

If your computer does not fit either of the two categories above, but it does have extended memory 
(memory beyond the 1Mb boundary), you can use a file for virtual heap backing store. However, 
rather than using a file on your hard disk, create a RAM disk in extended memory and, using the 
'-vmfn' command line option, designate the backing store file as a file on that RAM disk drive. This 
is tremendously faster than using an actual hard disk file. 
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•vme < pages_per_allocation_request > 

If you have Expanded Memory (LIM-compatible) in your computer, the Host Software can use it 
as a backing store medium for virtual heap memory. To/ enable access to Expanded Memory, you 
must have the appropriate 'DEVICE = ...' statement in your 'CONFIG.SYS' file. See the 
documentation accompanying your Expanded Memory board for the specific details on how to do 
this. 

The '-vme < pages_per_allocation_request >' option specifies the number of pages (16Kb per page) 
of Expanded Memory to request from the Expanded Memory Manager (EMM) each time the Host 
Software needs more Expanded Memory. 

Whenever a program requests some number of logical pages of expanded memory from the EMM, 
those pages are internally associated with a 'handle'. The total number of available handles, as well 
as the total number of available logical pages of expanded memory, are resources which could easily 
be exhausted. If the total number of EMM handles in your system is small, make sure that the value 
of '-vme < pages_per_allocation_request > ' is comparatively large. This will ensure that the available 
handles are not exhausted before the available logical pages of expanded memory. 

To disable use of Expanded Memory as a backing store medium altogether, specify '-vme 0'. 



-vmf <num_bufs> <buf_size> 

Specifies the number and size of the real-memory buffers to be used to support file backing store 
as a medium for virtual memory. If either < num_bufs > or < buf_siz > is zero, file backing store will 
not be used at all (i.e., it will be disabled). The integer specified for <buf_size> is the number of 
K-bytes to allocate for each real-memory buffer. 

You can change the path/name of the default backing store file ($VHEAP$) using the '-vmfn' 
option. 

To disable use of the file backing store medium altogether, specify '-vmf 0'. 
-vmfn <file_name> 

If your system has only Extended Memory, but no Expanded Memory, you can significantly speed 
up access to the backing store file by creating a RAM disk in Extended Memory and then specifying 
the backing store file name as a file on that RAM disk (e.g., '-vmf E:\TMPFILE', where E: is the 
RAM disk drive). 
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Misc | Virtual Memory Command 



The Misc | Virtual Memory command displays the following information about the current usage of virtual 
heap memory: 

Expanded Memory Backing Store 

EMM Version is the version number of the Expanded Memory Manager (EMM) device driver 
installed in your system. You can use EMM versions 3.2 and beyond. 

Page Frame Segment is the segment address of the 64K area called the page frame. This will be 
somewhere above the conventional memory area used by DOS (0-640K) and below the 1M boundary 
of the upper memory area. The actual address depends on your computer's configuration. 

Mappable Physical Pages is the number of physical pages in the upper memory area (640K-1M) of 
your computer into which expanded memory pages can be mapped (or swapped). The number here 
is the sum of the: 

1) number of pages in the Page Frame (usually 4), 

2) number of additional mappable pages above the 640K boundary. 

Note that your system may have other mappable pages below the 640K boundary, but the Host 
Software will not use these pages. 

This number represents the amount of expanded memory that the Host Software can reference 
directly at any particular time. The larger the value, the more likely that the memory area/node being 
referenced is directly accessible, and the less likely that the Host Software will need to swap pages to 
access the desired memory area/node. 

Total Pages is the total number of expanded memory pages in your computer. Each page contains 
16K of memory. 

Pages Available is the number of pages currently available for allocation by the EMM to the Host 
Software. The remainder, if any, of the expanded memory pages in your system are unavailable for 
use by the Host Software because they are allocated to other programs or device drivers. 

Pages Allocated to Host Software is the number of pages of expanded memory currently allocated 
to the Host Software. 

Currently In Use by Host Software is the percentage of expanded memory which the Host Software 
is currently using from the pool of expanded memory pages allocated to the Host Software. When 
this percentage reaches 100%, the Host Software will request more expanded memory pages from 
the EMM; the '-vme' command line option (page B-2) specifies how many pages will be requested. 

File Backing Store 

Real-Memory Buffers is the number of conventional memory buffers being used to swap blocks in 
from and out to the backing store file. The '-vmf' command line option (page B-2) specifies how many 
buffers to use. 

Buffer (Block) Size is the size of each conventional memory buffer used to swap blocks in from and 
out to the backing store file. The '-vmf command line option (page B-2) specifies this buffer size. 
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The product of Real-Memory Buffers times Buffer (Block) Size represents the amount of real 
memory that the Host Software can reference directly at any particular time. The larger the value, 
the more likely that the memory area/node being referenced is directly accessible, and the less likely 
that the Host Software will need to swap blocks to/from the backing store file to access the desired 
memory area/node. 

File Blocks Allocated is the number of blocks (of size Buffer (Block) Size each) currently needed by 
the Host Software. Essentially, this is the current size of the backing store file. 

Currently In Use by Host Software is the percentage of file backing store which the Host Software 
is currently actually using. When this percentage reaches 100%, the Host Software will increase the 
size of the backing store file to create more virtual memory. 



B-4 



